Set-CMPackage
修改包。
语法
Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-InputObject] <IResultObject>
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
-Id <String>
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-CMPackage
[-CopyToPackageShareOnDistributionPoint <Boolean>]
[-CustomPackageShareName <String>]
[-Description <String>]
[-DisconnectUserFromDistributionPoint <Boolean>]
[-DisconnectUserFromDistributionPointMins <UInt32>]
[-DisconnectUserFromDistributionPointRetry <UInt32>]
[-DistributionPointUpdateSchedule <IResultObject>]
[-EnableBinaryDeltaReplication <Boolean>]
[-Language <String>]
[-Manufacturer <String>]
[-MifFileName <String>]
[-MifName <String>]
[-MifPublisher <String>]
[-MifVersion <String>]
[-MulticastAllow <Boolean>]
[-MulticastEncrypt <Boolean>]
[-MulticastTransferOnly <Boolean>]
-Name <String>
[-NewName <String>]
[-PassThru]
[-Path <String>]
[-PersistContentInCache <Boolean>]
[-PrestageBehavior <PrestageBehavior>]
[-Priority <Priorities>]
[-SendToPreferredDistributionPoint <Boolean>]
[-Version <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
使用此 cmdlet 可更改程序包的设置。 有关详细信息，请参阅 Configuration Manager 中的程序包和程序。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。
示例
示例 1：重命名程序包并添加说明
此命令将 ID 为 ST120001 的包重命名为 ScriptsPackage02 并添加说明。
Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."示例 2：更改程序包源路径
第一个命令获取 ID 为 ST120001的程序包，将结果存储在 $Pkg 变量中 。 第二个命令更改程序包源路径。
$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"参数
-Confirm
添加此参数以在 cmdlet 运行之前提示确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CopyToPackageShareOnDistributionPoint
客户端始终可以从分发点下载程序包。 如果此参数设置为 $true，则站点会通过分发点上的命名网络共享提供此参数。 使用 CustomPackageShareName 指定自定义共享名称。
启用此选项时，分发点上需要更多空间。 它适用于分发此程序包的所有分发点。
| Type: | Boolean |
| Aliases: | ShareContent, CopyToPackageShareOnDistributionPoints |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomPackageShareName
如果启用 CopyToPackageShareOnDistributionPoint，可以使用此参数自定义共享名称。 最大长度为 127 个字符，不能包括下列任何字符： " / [ ] : | < > + = ; , ? * 。 可以指定共享名称和文件夹名称，但每个名称的最大值为 80 个字符。 例如，ShareName\FolderName。
| Type: | String |
| Aliases: | ShareName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPoint
此选项已弃用。 它设置 驱动程序包的 ForcedDisconnectEnabled 属性。
| Type: | Boolean |
| Aliases: | ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointMins
此选项已弃用。 它设置 驱动程序包的 ForcedDisconnectDelay 属性。
| Type: | UInt32 |
| Aliases: | ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisconnectUserFromDistributionPointRetry
此选项已弃用。 它设置 驱动程序包的 ForcedDisconnectNumRetries 属性。
| Type: | UInt32 |
| Aliases: | ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DistributionPointUpdateSchedule
使用此参数按计划更新分发点。 若要获取 schedule 对象，请使用 New-CMSchedule cmdlet。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBinaryDeltaReplication
设置此参数以 $true BDR (二进制差异) 。 有关详细信息，请参阅 Configuration Manager 中内容管理的基本概念。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
指定要配置的程序包的 ID。 此值是标准程序包 ID，例如 XYZ00020 ：。
| Type: | String |
| Aliases: | PackageId |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定要配置的包对象。 若要获取此对象，请使用 Get-CMPackage cmdlet。
| Type: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Language
指定包的语言字符串。 您选择用于标识语言版本的格式最多可包含 32 个字符。 为了标识程序包，Configuration Manager 使用Language、Manufacturer、Name和Version参数。 **** **** 例如，你可以拥有英文版和德语版同一程序包。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Manufacturer
指定软件的制造商名称。 最多可使用 32 个字符。 为了标识程序包，Configuration Manager 使用Language、Manufacturer、Name和Version参数。 **** ****
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MifFileName
指定包含程序包状态的 MIF (格式) 文件的名称。 文件扩展名必须为 .mif 。 使用状态 MIF 文件生成详细的状态报告。 若要生成状态 MIF 文件，应用程序必须调用 InstallStatusMIF 函数。 有关详细信息，请参阅状态 MIF 函数。
如果设置此参数，当客户端运行部署时，Configuration Manager 客户端将查找目录或目录中指定的安装状态 %TEMP% %windir% MIF 文件。 安装状态指示程序是否成功运行。
如果客户端找不到该文件，它将搜索这些目录中的所有 MIF 文件。 它会将为MifName、MifPublisher和MifVersion指定的值与MIF文件指定的值进行不区分大小写的比较。 如果客户端找到匹配项，它将使用 MIF 文件指定为程序安装状态的状态。 如果找不到匹配项，或者未指定 MifFileName， 客户端将使用程序退出代码设置程序的安装状态。 退出代码为零表示程序已成功运行。 任何其他值都指示特定于应用程序的错误代码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MifName
指定程序包名称进行 MIF 匹配，最多 50 个字符。 有关详细信息，请参阅 MifFileName 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MifPublisher
指定程序包的软件发布者进行 MIF 匹配，最多 32 个字符。 有关详细信息，请参阅 MifFileName 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MifVersion
指定程序包的版本号进行 MIF 匹配，最多 32 个字符。 有关详细信息，请参阅 MifFileName 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MulticastAllow
设置此参数 $true 允许通过多播传输此程序包。 有关详细信息，请参阅使用多播部署Windows配置管理器。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MulticastEncrypt
如果启用 MulticastAllow，则设置此参数 $true 加密多播包。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MulticastTransferOnly
如果启用 MulticastAllow，则此参数 设置为 $true 以仅通过多播传输此驱动程序包。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
使用此参数可重命名包。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
添加此参数可返回一个对象，该对象表示要处理的项目。 默认情况下，此 cmdlet 可能不会生成任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
如果包包含源文件，请指定文件的位置。 可以在站点服务器上指定完整本地路径，也可以指定网络路径。 确保此位置包含程序需要运行的所有文件和子目录，包括任何脚本。
| Type: | String |
| Aliases: | PackageSourcePath |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistContentInCache
如果不希望此包的内容从客户端缓存中退出来为其他内容提供空间，请设置此参数 $true以在 客户端缓存中保留它。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrestageBehavior
指定为预暂存内容启用分发点时的行为：
ManualCopy：手动将此包中的内容复制到分发点DownloadDelta：仅下载对分发点的内容更改OnDemand：将包分配给分发点时自动下载内容
有关详细信息，请参阅使用 预暂存的内容。
| Type: | PrestageBehavior |
| Accepted values: | ManualCopy, DownloadDelta, OnDemand |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
指定网站将内容发送到其他网站和此网站中的分发点的顺序。
网站先发送高优先级内容，然后再发送具有普通优先级或低优先级的包。 优先级相同的程序包按其创建顺序发送。
| Type: | Priorities |
| Aliases: | DistributionPriority |
| Accepted values: | High, Normal, Low |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendToPreferredDistributionPoint
如果要启用到首选分发点的按需内容分发，则此参数设置为 $true。 启用此设置后，如果客户端请求程序包的内容，并且该内容在任何分发点上不可用，则管理点将分发内容。 有关详细信息，请参阅 按需内容分发。
| Type: | Boolean |
| Aliases: | SendToPreferredDistributionPoints |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
指定软件的版本号。 此字符串的最大长度为 32 个字符。 为了标识程序包，Configuration Manager 使用Language、Manufacturer、Name和Version参数。 **** ****
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名称
指定程序包名称。 最多可使用 250 个字符。 为了标识程序包，Configuration Manager 使用Language、Manufacturer、Name和Version参数。 **** ****
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-描述
指定程序包的可选说明以帮助你识别它。 最多可使用 128 个字符。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object