Set-CMOperatingSystemImage

모듈:

ConfigurationManager

OS 이미지의 구성 설정을 변경합니다.

Syntax

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>]

Description

Set-CMOperatingSystemImage cmdlet은 Configuration Manager 하나 이상의 OS 이미지의 구성 설정을 변경합니다. OS 이미지는 .wim 형식 파일이며 컴퓨터에 OS를 성공적으로 설치하고 구성하는 데 필요한 Configuration Manager 참조 파일 및 폴더의 압축된 컬렉션을 나타냅니다.

참고

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을 실행하기 전에 확인 메시지를 표시합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CopyToPackageShareOnDistributionPoint

Type:	Boolean
Aliases:	CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomPackageShareName

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

OS 이미지에 대한 설명을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPoint

Type:	Boolean
Aliases:	DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointMins

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsMinutes
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetryCount

Type:	UInt32
Aliases:	DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableBinaryDeltaReplication

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

ForceWildcardHandling은 와일드카드 문자를 처리하며 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

OS 이미지의 ID 배열을 지정합니다.

Type:	String
Aliases:	PackageId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

CMOperatingSystemImage 개체를 지정합니다. CMOperatingSystemImage 개체를 가져오려면 Get-CMOperatingSystemImage cmdlet을 사용합니다.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MulticastAllow

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MulticastEncrypt

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MulticastTransferOnly

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

OS 이미지의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

OS 이미지의 새 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

OS 이미지 원본 .wim 파일의 네트워크 경로를 지정합니다.

Type:	String
Aliases:	PackageSourcePath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistContentInCache

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrestageBehavior

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

배포 유형의 우선 순위에 대한 변경 사항을 지정합니다. 유효한 값은 증가 및 감소입니다.

Type:	Priority
Accepted values:	High, Medium, Low
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Reload

버전 2006 이상에 적용됩니다. 외부 도구를 사용하여 이미지 속성을 변경하는 경우 이 옵션을 사용하여 사이트 데이터베이스의 정보를 다시 로드합니다.

Type:	SwitchParameter
Aliases:	ReloadImage
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

Type:	Boolean
Aliases:	SendToPreferredDistributionPoints
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

OS 이미지의 버전을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

관련 링크

• Get-CMOperatingSystemImage
• New-CMOperatingSystemImage
• Remove-CMOperatingSystemImage
• Get-CMOperatingSystemImageUpdateSchedule