Set-CMPackage

模块:

ConfigurationManager

修改包。

语法

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 运行之前提示确认。

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

-CopyToPackageShareOnDistributionPoint

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

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

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

-CustomPackageShareName

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

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

-Description

指定包的可选说明，以帮助识别它。 最多可以使用 128 个字符。

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

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

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

-DisconnectUserFromDistributionPointMins

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

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

-DisconnectUserFromDistributionPointRetry

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

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

-DistributionPointUpdateSchedule

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

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

-EnableBinaryDeltaReplication

将此参数设置为 $true 以启用 BDR) (二进制差异复制。 有关详细信息，请参阅 Configuration Manager 中内容管理的基本概念。

类型:	Boolean
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-CMPackage cmdlet。

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

-Language

为包指定语言字符串。 最多可以使用 32 个字符，该格式选择用于标识语言版本。 为了标识包，Configuration Manager 使用语言、制造商、名称和版本参数。 例如，可以具有同一包的英语版本和德语版本。

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

-Manufacturer

指定软件的制造商名称。 最多可以使用 32 个字符。 为了标识包，Configuration Manager 使用语言、制造商、名称和版本参数。

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

-MifFileName

指定管理信息格式 (MIF) 包含包状态的文件的名称。 文件扩展名必须为 .mif。 使用状态 MIF 文件生成详细的状态报告。 若要生成状态 MIF 文件，应用程序必须调用 InstallStatusMIF 函数。 有关详细信息，请参阅 状态 MIF 函数。

如果设置此参数，则当客户端运行部署时，Configuration Manager 客户端会在 %TEMP% 目录或 %windir% 目录中查找指定的安装状态 MIF 文件。 安装状态指示程序是否成功运行。

如果客户端找不到该文件，它会搜索这些目录中的所有 MIF 文件。 它将为 MifName、 MifPublisher 和 MifVersion 指定的值与 MIF 文件指定的值进行不区分大小写的比较。 如果客户端找到匹配项，它将使用 MIF 文件指定的状态作为程序的安装状态。 如果找不到匹配项，或者未指定 MifFileName，则客户端将使用程序退出代码来设置程序的安装状态。 退出代码为零表示程序已成功运行。 任何其他值指示特定于应用程序的错误代码。

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

-MifName

指定 MIF 匹配的包的名称，最多 50 个字符。 有关详细信息，请参阅 MifFileName 参数。

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

-MifPublisher

指定包的软件发布者进行 MIF 匹配，最多 32 个字符。 有关详细信息，请参阅 MifFileName 参数。

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

-MifVersion

指定 MIF 匹配的包的版本号，最多 32 个字符。 有关详细信息，请参阅 MifFileName 参数。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	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

指定包名称。 最多可以使用 250 个字符。 为了标识包，Configuration Manager 使用语言、制造商、名称和版本参数。

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

-NewName

使用此参数重命名包。

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

-PassThru

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

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

-Path

如果包包含源文件，请指定文件的位置。 可以在站点服务器上指定完整的本地路径，也可以指定网络路径。 确保此位置包含程序需要运行的所有文件和子目录，包括任何脚本。

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

-PersistContentInCache

如果不希望此包的内容在客户端缓存之外过期，以便为其他内容腾出空间，请将此参数设置为 $true 以将其保留在客户端缓存中。

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

-PrestageBehavior

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

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

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

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

-Priority

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

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

类型:	Priorities
别名:	DistributionPriority
接受的值:	High, Normal, Low
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SendToPreferredDistributionPoint

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

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

-Version

指定软件的版本号。 此字符串的最大长度为 32 个字符。 为了标识包，Configuration Manager 使用语言、制造商、名称和版本参数。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Export-CMPackage
• Get-CMPackage
• Import-CMPackage
• New-CMPackage
• Remove-CMPackage
• Configuration Manager 中的包和程序