Set-CMOperatingSystemImage

更改 OS 映像的配置设置。

语法

Set-CMOperatingSystemImage
   [-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-CMOperatingSystemImage
   [-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-CMOperatingSystemImage
   [-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-CMOperatingSystemImage cmdlet 更改 Configuration Manager 中一个或多个 OS 映像的配置设置。 OS 映像是 .wim 格式化文件,表示 Configuration Manager 在计算机上成功安装和配置 OS 所需的引用文件和文件夹的压缩集合。

注意

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

示例

示例 1:使用 ID 更改 OS 映像的设置

此命令更改 ID 为 Cm10004f 的 OS 映像的配置设置。 命令将重命名 OS 映像,添加版本和说明,并指定 OS 映像的安装源文件的路径。

Set-CMOperatingSystemImage -Id "Cm10004f" -NewName "Microsoft Windows 8 (x64)" -Version "I20C" -Description "Dept02 Sys Image" -Path "\\Contoso\Public\OSD\win8x64.wim"

示例 2:使用名称将 OS 映像添加到安全范围

此命令将成员身份添加到名为 ImagePkg01 的 OS 映像的名为 SecScope02 的安全作用域。

Set-CMOperatingSystemImage -SecurityScopeAction AddMembership -SecurityScopeName "SecScope02" -Name "ImagePkg01"

示例 3:从安全范围中删除 OS 映像

此命令从名为 ImagePkg01 的 OS 映像的安全作用域中删除名为 SecScope02 的成员身份。

Set-CMOperatingSystemImage -SecurityScopeAction RemoveMembership -SecurityScopeName "SecScope02" -Name "ImagePkg01"

参数

-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

ForceWildcardHandling 处理通配符,并可能导致意外行为, (不建议) 。 无法与 DisableWildcardHandling 组合使用。

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

-Id

指定 OS 映像的 ID 数组。

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

-InputObject

指定 CMOperatingSystemImage 对象。 若要获取 CMOperatingSystemImage 对象,请使用 Get-CMOperatingSystemImage 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 映像源 .wim 文件的网络路径。

类型: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