Set-CMDriverPackage

参考

模块:: ConfigurationManager

修改驱动程序包。

语法

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 修改驱动程序包。

有关详细信息，请参阅在 Configuration Manager 中管理驱动程序。

注意

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。有关详细信息，请参阅入门。

示例

示例 1：配置驱动程序包的制造商和型号

此命令使用 ID XYZ00091 配置驱动程序包的制造商和型号。

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-CopyToPackageShareOnDistributionPoint

客户端始终可以从分发点下载驱动程序包。如果将此参数设置为 $true，则站点会通过分发点上的命名网络共享来提供该参数。使用 CustomPackageShareName 指定自定义共享名称。

启用此选项后，分发点上需要更多空间。它适用于将此驱动程序包分发到的所有分发点。

类型:	Boolean
别名:	CopyToPackageShareOnDistributionPoints
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CustomPackageShareName

如果启用 CopyToPackageShareOnDistributionPoint，则可以使用此参数自定义共享名称。最大长度为 127 个字符，不能包括以下任何字符： " / [ ] : | < > + = ; , ? *。可以指定共享名称和文件夹名称，但每个名称的最大数目为 80 个字符。例如，ShareName\FolderName。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

指定驱动程序包的可选说明，以帮助你识别它。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。不能将其与 ForceWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisconnectUserFromDistributionPoint

此选项已弃用。它设置驱动程序包的 ForcedDisconnectEnabled 属性。

类型:	Boolean
别名:	DisconnectUsersFromDistributionPoints
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisconnectUserFromDistributionPointMins

此选项已弃用。它设置驱动程序包的 ForcedDisconnectDelay 属性。

类型:	UInt32
别名:	DisconnectUsersFromDistributionPointsMinutes
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisconnectUserFromDistributionPointRetryCount

此选项已弃用。它设置驱动程序包的 ForcedDisconnectNumRetries 属性。

类型:	UInt32
别名:	DisconnectUsersFromDistributionPointsRetries
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DistributionPointUpdateSchedule

使用此参数按计划更新分发点。若要获取计划对象，请使用 New-CMSchedule cmdlet。

类型:	IResultObject
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriverManufacturer

使用此参数设置设备的制造商。最大长度为 100 个字符。

将其与 DriverModel 参数一起使用。可以使用它们来管理驱动程序目录，以及用于任务序列预缓存。有关详细信息，请参阅为任务序列配置预缓存内容。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriverModel

使用此参数可设置设备的模型。最大长度为 100 个字符。

将其与 DriverManufacturer 参数一起使用。可以使用它们来管理驱动程序目录，以及用于任务序列预缓存。有关详细信息，请参阅为任务序列配置预缓存内容。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DriverPackageSource

指定网络位置的文件路径，以源驱动程序文件。

创建驱动程序包时，包的源位置必须指向另一个驱动程序包未使用的空网络共享。 SMS 提供程序必须对该位置具有 完全控制 权限。

将设备驱动程序添加到驱动程序包时，Configuration Manager 会将其复制到此路径。只能将已导入并在驱动程序目录中启用的设备驱动程序添加到驱动程序包。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为， (不建议) 。不能将其与 DisableWildcardHandling 组合使用。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Id

指定要配置的驱动程序包的 ID。此值是标准包 ID，例如： XYZ00020。

类型:	String
别名:	PackageId
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

指定要配置的驱动程序包对象。若要获取此对象，请使用 Get-CMDriverPackage cmdlet。

类型:	IResultObject
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-MulticastAllow

将此参数设置为 $true 以允许通过多播传输此包。有关详细信息，请参阅使用多播通过 Configuration Manager 通过网络部署 Windows。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MulticastEncrypt

如果启用 MulticastAllow，请将此参数设置为 $true 以加密多播包。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MulticastTransferOnly

如果启用 MulticastAllow，请将此参数设置为 $true 以仅通过多播传输此驱动程序包。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定要配置的驱动程序包的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NewName

为驱动程序包指定新名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。默认情况下，此 cmdlet 可能不会生成任何输出。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PrestageBehavior

为预留内容启用分发点时指定行为：

ManualCopy：手动将此包中的内容复制到分发点
DownloadDelta：仅将内容更改下载到分发点
OnDemand：将包分配到分发点时自动下载内容

有关详细信息，请参阅使用预留内容。

类型:	PrestageBehavior
接受的值:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Priority

指定站点将内容发送到其他站点和此站点中的分发点的顺序。

网站在优先级为中等或低优先级的包之前发送高优先级内容。优先级相等的包按创建顺序发送。

类型:	Priority
接受的值:	High, Medium, Low
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SendToPreferredDistributionPoint

如果要启用首选分发点的按需内容分发，请将此参数设置为 $true。启用此设置时，如果客户端请求包的内容，并且内容在任何分发点上都不可用，则管理点将分发内容。有关详细信息，请参阅按需内容分发。

类型:	Boolean
别名:	SendToPreferredDistributionPoints
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Version

指定驱动程序包的版本。此值是你管理的字符串。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

通过

Set-CMDriverPackage

语法

说明

示例

示例 1：配置驱动程序包的制造商和型号

参数

-Confirm

-CopyToPackageShareOnDistributionPoint

-CustomPackageShareName

-Description

-DisableWildcardHandling

-DisconnectUserFromDistributionPoint

-DisconnectUserFromDistributionPointMins

-DisconnectUserFromDistributionPointRetryCount

-DistributionPointUpdateSchedule

-DriverManufacturer

-DriverModel

-DriverPackageSource

-ForceWildcardHandling

-Id

-InputObject

-MulticastAllow

-MulticastEncrypt

-MulticastTransferOnly

-Name

-NewName

-PassThru

-PrestageBehavior

-Priority

-SendToPreferredDistributionPoint

-Version

-WhatIf

输入

输出

反馈

其他资源

通过

Set-CMDriverPackage

语法

说明

示例

示例 1：配置驱动程序包的制造商和型号

参数

-Confirm

-CopyToPackageShareOnDistributionPoint

-CustomPackageShareName

-Description

-DisableWildcardHandling

-DisconnectUserFromDistributionPoint

-DisconnectUserFromDistributionPointMins

-DisconnectUserFromDistributionPointRetryCount

-DistributionPointUpdateSchedule

-DriverManufacturer

-DriverModel

-DriverPackageSource

-ForceWildcardHandling

-Id

-InputObject

-MulticastAllow

-MulticastEncrypt

-MulticastTransferOnly

-Name

-NewName

-PassThru

-PrestageBehavior

-Priority

-SendToPreferredDistributionPoint

-Version

-WhatIf

输入

输出

相关链接

反馈

其他资源