< Back
Add-HPEOSPWindowsDriver
Post
NAME Add-HPEOSPWindowsDriver
SYNOPSIS
The Add-HPEOSPWindowsDriver cmdlet adds drivers to an offline Windows ISO.
SYNTAX
Add-HPEOSPWindowsDriver [-ImageFile] <String> [-Driver] <String> [-ImageIndex <Int32>] [-OutputFile <String>]
[<CommonParameters>]
DESCRIPTION
The Add-HPEOSPWindowsDriver cmdlet adds third-party driver packages to an offline Windows ISO.
PARAMETERS
-ImageFile <String>
Specifies the Windows ISO file as input. The value must be the Windows local full path.
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-Driver <String>
Specifies the .inf file or folder containing the .inf files of the drivers you want to add. When you specify a
folder, .inf files that are not valid driver packages are ignored. These files are reported on the console
when the command runs, and a warning is included in the log file. You will not receive an error message.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ImageIndex [<Int32>]
Specifies the index number of a Windows image in the install.wim file. When ImageIndex is not specified, the
drivers will be added to each of the image in ISO, which might take longer.
Note:
Use the Get-WindowsImage cmdlet to get information about a Windows image in install.wim file.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-OutputFile [<String>]
Specifies the output file to create a new Windows ISO after adding the drivers. The value must be the Windows
local full path.
Required? false
Position? named
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
System.String
OUTPUTS
None
When the cmdlet does not execute correctly, output with the error message is produced. Otherwise, this cmdlet
does not generate any output.
NOTES
???? Not supplying OutputFile overwrites the input ISO file.
???? This cmdlet only supports Windows Server 2012 R2 or Windows Server 2016 ISO.
???? An ISO is created with efisys_noprompt.bin which bypasses the "Press any key to boot from CD or DVD ...."
prompt when booting the installer.
EXAMPLE 1
PS C:\\> Add-HPEOSPWindowsDriver -ImageFile C:\\TestFolder\\WindowsServer2012R2.iso -Driver C:\\Test\\Drivers
PS C:\\>
This command adds all drivers in the C:\\Test\\Drivers folder or any of its subdirectories to the Windows operating
system image and overwrites the input ISO.
EXAMPLE 2
PS C:\\> Add-HPEOSPWindowsDriver -ImageFile C:\\TestFolder\\WindowsServer2016.iso -Driver C:\\Test\\Drivers\\Usb.inf
-OutputFile C:\\TestFolder\\NewWindowsServer2016.iso
PS C:\\>
This command adds the driver package 'Usb.inf' to the Windows operating system ISO and creates a new ISO file in
OutputFile path.
EXAMPLE 3
PS C:\\> Add-HPEOSPWindowsDriver -ImageFile C:\\TestFolder\\WindowsServer2016DataCenter.iso -Driver
C:\\Test\\Drivers\\Usb.inf -ImageIndex 2
PS C:\\>
This command adds all drivers in the C:\\Test\\Drivers folder or any of its subdirectories at index 2 of install.wim
and overwrites the input ISO.
RELATED LINKS
http://www.hpe.com/servers/powershell
SYNOPSIS
The Add-HPEOSPWindowsDriver cmdlet adds drivers to an offline Windows ISO.
SYNTAX
Add-HPEOSPWindowsDriver [-ImageFile] <String> [-Driver] <String> [-ImageIndex <Int32>] [-OutputFile <String>]
[<CommonParameters>]
DESCRIPTION
The Add-HPEOSPWindowsDriver cmdlet adds third-party driver packages to an offline Windows ISO.
PARAMETERS
-ImageFile <String>
Specifies the Windows ISO file as input. The value must be the Windows local full path.
Required? true
Position? 0
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-Driver <String>
Specifies the .inf file or folder containing the .inf files of the drivers you want to add. When you specify a
folder, .inf files that are not valid driver packages are ignored. These files are reported on the console
when the command runs, and a warning is included in the log file. You will not receive an error message.
Required? true
Position? 1
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ImageIndex [<Int32>]
Specifies the index number of a Windows image in the install.wim file. When ImageIndex is not specified, the
drivers will be added to each of the image in ISO, which might take longer.
Note:
Use the Get-WindowsImage cmdlet to get information about a Windows image in install.wim file.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-OutputFile [<String>]
Specifies the output file to create a new Windows ISO after adding the drivers. The value must be the Windows
local full path.
Required? false
Position? named
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
System.String
OUTPUTS
None
When the cmdlet does not execute correctly, output with the error message is produced. Otherwise, this cmdlet
does not generate any output.
NOTES
???? Not supplying OutputFile overwrites the input ISO file.
???? This cmdlet only supports Windows Server 2012 R2 or Windows Server 2016 ISO.
???? An ISO is created with efisys_noprompt.bin which bypasses the "Press any key to boot from CD or DVD ...."
prompt when booting the installer.
EXAMPLE 1
PS C:\\> Add-HPEOSPWindowsDriver -ImageFile C:\\TestFolder\\WindowsServer2012R2.iso -Driver C:\\Test\\Drivers
PS C:\\>
This command adds all drivers in the C:\\Test\\Drivers folder or any of its subdirectories to the Windows operating
system image and overwrites the input ISO.
EXAMPLE 2
PS C:\\> Add-HPEOSPWindowsDriver -ImageFile C:\\TestFolder\\WindowsServer2016.iso -Driver C:\\Test\\Drivers\\Usb.inf
-OutputFile C:\\TestFolder\\NewWindowsServer2016.iso
PS C:\\>
This command adds the driver package 'Usb.inf' to the Windows operating system ISO and creates a new ISO file in
OutputFile path.
EXAMPLE 3
PS C:\\> Add-HPEOSPWindowsDriver -ImageFile C:\\TestFolder\\WindowsServer2016DataCenter.iso -Driver
C:\\Test\\Drivers\\Usb.inf -ImageIndex 2
PS C:\\>
This command adds all drivers in the C:\\Test\\Drivers folder or any of its subdirectories at index 2 of install.wim
and overwrites the input ISO.
RELATED LINKS
http://www.hpe.com/servers/powershell