Share via


Add-WdsDriverPackage

Add-WdsDriverPackage

Adds an existing driver package to a driver group or injects it into a boot image.

語法

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>]

詳細描述

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.

參數

-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. 此參數接受的值包括:

-- Arm
-- Ia64
-- X64
-- X86

別名

必要?

true

位置?

named

預設值

接受管線輸入?

True (ByPropertyName)

接受萬用字元?

false

-AsJob

別名

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-CimSession<CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件,例如 New-CimSessionGet-CimSession Cmdlet 的輸出。預設為本機電腦上的目前工作階段。

別名

Session

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

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.

別名

必要?

false

位置?

named

預設值

接受管線輸入?

True (ByPropertyName)

接受萬用字元?

false

-GroupName<String>

Specifies the name of a driver group. The cmdlet adds the driver package to this group.

別名

必要?

true

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-Id<Guid>

Specifies an ID. This is the ID of the driver package to add.

別名

必要?

true

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

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.

別名

必要?

true

位置?

named

預設值

接受管線輸入?

True (ByPropertyName)

接受萬用字元?

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.

別名

必要?

true

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-ThrottleLimit<Int32>

指定為執行此 Cmdlet 可建立的最大同時作業數。如果省略這個參數或輸入 0 的值,則 Windows PowerShell® 會根據在電腦上執行的 CIM Cmdlet 數目,計算 Cmdlet 的最佳節流限制。節流限制僅適用於目前 Cmdlet,不適用於工作階段或電腦。

別名

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

此 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 與 -OutVariable。如需詳細資訊,請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是您可以使用管線處理方式傳遞給 Cmdlet 的物件類型。

輸出

輸出類型是 Cmdlet 所發出的物件類型。

  • Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsDriverPackage

範例

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)"

相關主題

Disable-WdsDriverPackage

Enable-WdsDriverPackage

Get-WdsDriverPackage

Import-WdsDriverPackage

Remove-WdsDriverPackage