Set-CMDriverPackage
修改驱动程序包。
语法
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