Add-WdsDriverPackage
Add-WdsDriverPackage
Adds an existing driver package to a driver group or injects it into a boot image.
Syntax
Parameter Set: IdIntoBootImageProperties
Add-WdsDriverPackage -Architecture <Architecture> -Id <Guid> -ImageName <String> [-AsJob] [-CimSession <CimSession[]> ] [-FileName <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: IdIntoDriverGroupName
Add-WdsDriverPackage -GroupName <String> -Id <Guid> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: NameIntoBootImageProperties
Add-WdsDriverPackage -Architecture <Architecture> -ImageName <String> -Name <String> [-AsJob] [-CimSession <CimSession[]> ] [-FileName <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: NameIntoDriverGroupName
Add-WdsDriverPackage -GroupName <String> -Name <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Detaillierte Beschreibung
The Add-WdsDriverPackage cmdlet adds an existing driver package to a driver group or injects a driver package into a boot image. Use the Import-WdsDriverPackage cmdlet to import driver packages into the Windows Deployment Services driver store. Specify a driver package by its unique name or ID.
To add a driver package to a driver group, specify the group name. Use the Remove-WdsDriverPackage to remove a drive package from a group.
To inject a driver package into a boot image, specify the image name and architecture. If the image name and architecture do not uniquely identify the boot image, specify the boot image file. After you inject a driver package into a boot image, Windows Deployment Services cannot remove the driver package.
Parameter
-Architecture<Architecture>
Specifies an architecture. This is the architecture of the image. In order to inject a driver into a boot image, you must specify an architecture. Die folgenden Werte für diesen Parameter sind zulässig:
-- Arm
-- Ia64
-- X64
-- X86
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-AsJob
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-CimSession<CimSession[]>
Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.
Aliasse |
Session |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-FileName<String>
Specifies a file name. This is the file name of the boot image. Use this parameter to specify the file name for the boot image if the boot image name and architecture do not uniquely identify the image.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-GroupName<String>
Specifies the name of a driver group. The cmdlet adds the driver package to this group.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-Id<Guid>
Specifies an ID. This is the ID of the driver package to add.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ImageName<String>
Specifies the name of an image. This is the name of the boot image. If this name is not unique, specify the file name of the boot image by using the FileName parameter.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Name<String>
Specifies a name. This is the unique name of the driver package. If this name is not unique, specify the driver package ID, instead, by using the Id parameter.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ThrottleLimit<Int32>
Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0
eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsDriverPackage
Beispiele
Example 1: Add a driver package to a group by using the package ID
This command adds a driver package to the group named Drivers for Frabrikam Devices. The command specifies the ID of the driver package.
PS C:\> Add-WdsDriverPackage -Id 32d78628-07fb-4e18-adc4-f0ecf8b41bbe -GroupName "Drivers for Fabrikam Devices"
Example 2: Add a driver package to a group by using the package name
This command adds a driver package to the group named Drivers for Frabrikam Devices. The command specifies Fabrikam Device Driver (x64) as the name of the driver package.
PS C:\> Add-WdsDriverPackage -GroupName "Drivers for Fabrikam Devices" -Name "Fabrikam Device Driver (x64)"
Example 3: Inject a driver package into a boot image by using the package ID
This command injects the driver package into the boot image named Contoso general setup (x64). The command specifies the ID of the driver package.
PS C:\> Add-WdsDriverPackage -Architecture X64 -Id 32d78628-07fb-4e18-adc4-f0ecf8b41bbe -ImageName "Contoso general setup (x64)"
Example 4: Inject a driver package into a boot image by using the package name
This command injects the driver package into the boot image named Contoso general setup (x64). The command specifies Fabrikam Device Driver (x64) as the name of the driver package.
PS C:\> Add-WdsDriverPackage -Architecture X64 -ImageName "Contoso general setup (x64)" -Name "Fabrikam Device Driver (x64)"