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