Set-CMOperatingSystemInstaller

模块:

ConfigurationManager

更改 OS 升级包的配置设置。

语法

Set-CMOperatingSystemInstaller
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-Reload]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMOperatingSystemInstaller
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-Reload]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMOperatingSystemInstaller
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-Reload]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMOperatingSystemInstaller cmdlet 更改 Configuration Manager 中一个或多个 OS 升级包的配置设置。 OS 升级包包含 Configuration Manager 在引用计算机上安装 Windows OS 所需的所有文件。

注意

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

示例

示例 1：使用名称更改 OS 升级包的设置

此命令更改名为 Win8x64 的 OS 升级包的配置设置。 命令将重命名 OS 升级包，添加版本和说明，并指定 OS 升级包的安装源文件的路径。

Set-CMOperatingSystemInstaller -Name "Win8x64" -NewName "OsiWin8x64" -Version "I20B" -Description "Dept02 Sys Install" -Path "\\Win2k3X64contoso\Public\OSD\win8x64"

示例 2：使用名称将 OS 升级包添加到安全范围

此命令将成员身份添加到名为 InstPkg01 的 OS 升级包的 SecScope02 安全作用域。

Set-CMOperatingSystemInstaller -SecurityScopeAction AddMembership -SecurityScopeName "SecScope02" -Name "InstPkg01"

示例 3：从安全范围中删除 OS 升级包

此命令删除名为 InstPkg01 的 OS 升级包的 SecScope02 安全作用域的成员身份。

Set-CMOperatingSystemInstaller -SecurityScopeAction RemoveMembership -SecurityScopeName "SecScope02" -Name "InstPkg01"

参数

-Confirm

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

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

-CopyToPackageShareOnDistributionPoint

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

-CustomPackageShareName

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

-Description

指定 OS 升级包的说明。

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

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

-DisconnectUserFromDistributionPointMins

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

-DisconnectUserFromDistributionPointRetryCount

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

-DistributionPointUpdateSchedule

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

-EnableBinaryDeltaReplication

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

-ForceWildcardHandling

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

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

-Id

指定 OS 升级包的 ID 数组。

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

-InputObject

指定 CMOperatingSystemInstaller 对象。 若要获取 CMOperatingSystemInstaller 对象，请使用 Get-CMOperatingSystemInstaller cmdlet。

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

-MulticastAllow

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

-MulticastEncrypt

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

-MulticastTransferOnly

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

-Name

指定 OS 升级包的名称。

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

-NewName

指定 OS 升级包的新名称。

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

-PassThru

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

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

-Path

指定 OS 升级包的安装源文件的网络路径。

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

-PersistContentInCache

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

-PrestageBehavior

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

-Priority

指定部署类型的优先级的更改。 有效值为：增加和减少。

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

-Reload

适用于版本 2006 及更高版本。 如果使用外部工具更改图像属性，请使用此选项重新加载站点数据库中的信息。

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

-SendToPreferredDistributionPoint

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

-Version

指定 OS 升级包的版本。

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Get-CMOperatingSystemInstaller
• New-CMOperatingSystemInstaller
• Remove-CMOperatingSystemInstaller