< Back
Install-HPEOSPWindowsImage
Post
NAME Install-HPEOSPWindowsImage
SYNOPSIS
The Install-HPEOSPWindowsImage cmdlet installs the Windows operating system on Gen10 servers.
SYNTAX
Install-HPEOSPWindowsImage [-Connection] <Connection[]> [-ImageURL] <String[]> [<CommonParameters>]
DESCRIPTION
The Install-HPEOSPWindowsImage cmdlet installs the Windows operating system on one or more Gen10 servers. This
cmdlet mounts the input image, sets CD/DVD drive as bootable device, and reboots the server.
PARAMETERS
-Connection <Connection[]>
Connection object to iLO for OS Provisioning. This is a session object that identifies the target to which the
connection is established. The Connection object is created by the Connect-HPEOSP command using the
IP/Hostname and accompanying Username and Password to log into the iLO.
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-ImageURL <String[]>
Specifies the URL for the media image. The URL format is as follows:
protocol://username:password@hostname:port/filename.iso
- Protocol is mandatory and must be either http or https.
- Username:password is optional.
- Hostname is mandatory.
- Port is optional.
- Filename is mandatory.
For example:
https://john:abc123@imgserver.company.c ... 2012R2.iso
http://imgserver.company.com/os_image/W ... er2016.iso
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
HPE.OSP.Connection[]
System.String[]
OUTPUTS
System.Management.Automation.PSObject[]
NOTES
???? For complete automation of Windows OS installation, the input ISO file should have autounattend.xml and
necessary drivers.
???? Use the Use-HPEOSPWindowsUnattend cmdlet to add autounattend.xml into the ISO file.
???? Use the Add-HPEOSPWindowsDriver cmdlet to add third-party drivers into the ISO file.
???? If there are any pending changes in the BIOS or system utilities, the system might restart multiple times
and Virtual media can get disconnected. In this case you may have to run the cmdlet once again.
???? Install-HPEOSPWindowsImage cmdlet does not track the Windows installation progress.
???? Using the HPE iLO Integrated Remote Console (IRC) utility to check the status of the installation is
recommended.
???? See the User Guide document for more details about prerequisites before installing the Windows OS on Gen10
servers and any errors.
???? Install-HPEOSPWindowsImage dismounts the existing mounted image and mounts the input image in URL.
EXAMPLE 1
PS C:\\> $connection = Connect-HPEOSP -IP 10.20.30.1 -Username admin -Password admin123
-DisableCertificateAuthentication
PS C:\\> $connection | Install-HPEOSPWindowsImage -ImageURL
"http://10.20.30.10/WindowsOS/WindowsSer ... center.iso"
IP : 10.20.30.1
Hostname : abc1.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
PS C:\\>
This example shows the output of the Install-HPEOSPWindowsImage cmdlet on a Gen10 server.
EXAMPLE 2
PS C:\\> $connection = Connect-HPEOSP -IP 10.20.30.1,10.20.30.2,10.20.30.3 -Username admin -Password admin123
-DisableCertificateAuthentication
PS C:\\> $connection | Install-HPEOSPWindowsImage -ImageURL
"http://10.20.30.10/WindowsOS/WindowsSer ... center.iso"
IP : 10.20.30.1
Hostname : abc1.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
IP : 10.20.30.2
Hostname : abc2.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
IP : 10.20.30.3
Hostname : abc3.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
PS C:\\>
This example shows the output of the Install-HPEOSPWindowsImage cmdlet on one or more Gen10 servers. All the
servers uses the same ISO image file.
EXAMPLE 3
PS C:\\> $connection = Connect-HPEOSP -IP 10.20.30.1,10.20.30.2 -Username admin -Password admin123
-DisableCertificateAuthentication
PS C:\\> Install-HPEOSPWindowsImage -Connection $connection -ImageURL "http://10.20.30.10/WindowsOS/WindowsServer201
2R2_Datacenter.iso","http://10.20.30.10/WindowsOS/WindowsSer ... center.iso"
IP : 10.20.30.1
Hostname : abc1.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
IP : 10.20.30.2
Hostname : abc2.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
PS C:\\>
This example shows the output of the Install-HPEOSPWindowsImage cmdlet on one or more Gen10 servers. Each servers
uses different ISO image files.
RELATED LINKS
http://www.hpe.com/servers/powershell
Connect-HPEOSP
SYNOPSIS
The Install-HPEOSPWindowsImage cmdlet installs the Windows operating system on Gen10 servers.
SYNTAX
Install-HPEOSPWindowsImage [-Connection] <Connection[]> [-ImageURL] <String[]> [<CommonParameters>]
DESCRIPTION
The Install-HPEOSPWindowsImage cmdlet installs the Windows operating system on one or more Gen10 servers. This
cmdlet mounts the input image, sets CD/DVD drive as bootable device, and reboots the server.
PARAMETERS
-Connection <Connection[]>
Connection object to iLO for OS Provisioning. This is a session object that identifies the target to which the
connection is established. The Connection object is created by the Connect-HPEOSP command using the
IP/Hostname and accompanying Username and Password to log into the iLO.
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-ImageURL <String[]>
Specifies the URL for the media image. The URL format is as follows:
protocol://username:password@hostname:port/filename.iso
- Protocol is mandatory and must be either http or https.
- Username:password is optional.
- Hostname is mandatory.
- Port is optional.
- Filename is mandatory.
For example:
https://john:abc123@imgserver.company.c ... 2012R2.iso
http://imgserver.company.com/os_image/W ... er2016.iso
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
HPE.OSP.Connection[]
System.String[]
OUTPUTS
System.Management.Automation.PSObject[]
NOTES
???? For complete automation of Windows OS installation, the input ISO file should have autounattend.xml and
necessary drivers.
???? Use the Use-HPEOSPWindowsUnattend cmdlet to add autounattend.xml into the ISO file.
???? Use the Add-HPEOSPWindowsDriver cmdlet to add third-party drivers into the ISO file.
???? If there are any pending changes in the BIOS or system utilities, the system might restart multiple times
and Virtual media can get disconnected. In this case you may have to run the cmdlet once again.
???? Install-HPEOSPWindowsImage cmdlet does not track the Windows installation progress.
???? Using the HPE iLO Integrated Remote Console (IRC) utility to check the status of the installation is
recommended.
???? See the User Guide document for more details about prerequisites before installing the Windows OS on Gen10
servers and any errors.
???? Install-HPEOSPWindowsImage dismounts the existing mounted image and mounts the input image in URL.
EXAMPLE 1
PS C:\\> $connection = Connect-HPEOSP -IP 10.20.30.1 -Username admin -Password admin123
-DisableCertificateAuthentication
PS C:\\> $connection | Install-HPEOSPWindowsImage -ImageURL
"http://10.20.30.10/WindowsOS/WindowsSer ... center.iso"
IP : 10.20.30.1
Hostname : abc1.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
PS C:\\>
This example shows the output of the Install-HPEOSPWindowsImage cmdlet on a Gen10 server.
EXAMPLE 2
PS C:\\> $connection = Connect-HPEOSP -IP 10.20.30.1,10.20.30.2,10.20.30.3 -Username admin -Password admin123
-DisableCertificateAuthentication
PS C:\\> $connection | Install-HPEOSPWindowsImage -ImageURL
"http://10.20.30.10/WindowsOS/WindowsSer ... center.iso"
IP : 10.20.30.1
Hostname : abc1.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
IP : 10.20.30.2
Hostname : abc2.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
IP : 10.20.30.3
Hostname : abc3.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
PS C:\\>
This example shows the output of the Install-HPEOSPWindowsImage cmdlet on one or more Gen10 servers. All the
servers uses the same ISO image file.
EXAMPLE 3
PS C:\\> $connection = Connect-HPEOSP -IP 10.20.30.1,10.20.30.2 -Username admin -Password admin123
-DisableCertificateAuthentication
PS C:\\> Install-HPEOSPWindowsImage -Connection $connection -ImageURL "http://10.20.30.10/WindowsOS/WindowsServer201
2R2_Datacenter.iso","http://10.20.30.10/WindowsOS/WindowsSer ... center.iso"
IP : 10.20.30.1
Hostname : abc1.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
IP : 10.20.30.2
Hostname : abc2.domain.com
Status : Information
StatusInfo : @{Category=Information; Message=Installation might require several minutes to complete. Please use
iLO IRC to check the status.}
Image : http://10.20.30.10/WindowsOS/WindowsSer ... center.iso
Inserted : True
PS C:\\>
This example shows the output of the Install-HPEOSPWindowsImage cmdlet on one or more Gen10 servers. Each servers
uses different ISO image files.
RELATED LINKS
http://www.hpe.com/servers/powershell
Connect-HPEOSP