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

Description

이 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
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CopyToPackageShareOnDistributionPoint

클라이언트는 항상 배포 지점에서 패키지를 다운로드할 수 있습니다. 이 매개 변수를 $true 설정하면 사이트에서 배포 지점에서 명명된 네트워크 공유를 통해 사용할 수 있습니다. CustomPackageShareName을 사용하여 사용자 지정 공유 이름을 지정합니다.

이 옵션을 사용하도록 설정하면 배포 지점에 더 많은 공간이 필요합니다. 이 패키지는 이 패키지를 배포하는 모든 배포 지점에 적용됩니다.

형식:	Boolean
별칭:	ShareContent, CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CustomPackageShareName

CopyToPackageShareOnDistributionPoint를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 공유 이름을 사용자 지정할 수 있습니다. 최대 길이는 127자이며 다음 문자를 " / [ ] : | < > + = ; , ? *포함할 수 없습니다. 공유 이름과 폴더 이름을 지정할 수 있지만 각각에 대한 최대값은 80자입니다. 예를 들면 ShareName\FolderName와 같습니다.

형식:	String
별칭:	ShareName
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Description

패키지를 식별하는 데 도움이 되는 선택적 설명을 지정합니다. 최대 128자를 사용할 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableWildcardHandling

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisconnectUserFromDistributionPoint

이 옵션은 더 이상 사용되지 않습니다. 드라이버 패키지의 ForcedDisconnectEnabled 속성을 설정합니다.

형식:	Boolean
별칭:	ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisconnectUserFromDistributionPointMins

이 옵션은 더 이상 사용되지 않습니다. 드라이버 패키지의 ForcedDisconnectDelay 속성을 설정합니다.

형식:	UInt32
별칭:	ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisconnectUserFromDistributionPointRetry

이 옵션은 더 이상 사용되지 않습니다. 드라이버 패키지의 ForcedDisconnectNumRetries 속성을 설정합니다.

형식:	UInt32
별칭:	ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DistributionPointUpdateSchedule

이 매개 변수를 사용하여 일정에 따라 배포 지점을 업데이트합니다. 일정 개체를 얻으려면 New-CMSchedule cmdlet을 사용합니다.

형식:	IResultObject
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnableBinaryDeltaReplication

이 매개 변수를 $true 설정하여 BDR(이진 차등 복제)을 사용하도록 설정합니다. 자세한 내용은 Configuration Manager의 콘텐츠 관리에 대한 기본 개념을 참조하세요.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ForceWildcardHandling

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Id

구성할 패키지의 ID를 지정합니다. 이 값은 표준 패키지 ID(예: ) XYZ00020입니다.

형식:	String
별칭:	PackageId
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

구성할 패키지 개체를 지정합니다. 이 개체를 얻으려면 Get-CMPackage cmdlet을 사용합니다.

형식:	IResultObject
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-Language

패키지에 대한 언어 문자열을 지정합니다. 언어 버전을 식별하는 데 사용할 형식으로 최대 32자를 사용할 수 있습니다. 패키지를 식별하기 위해 Configuration Manager는 언어, 제조업체, 이름 및 버전 매개 변수를 사용합니다. 예를 들어 영어 버전과 동일한 패키지의 독일어 버전을 사용할 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Manufacturer

소프트웨어의 제조업체 이름을 지정합니다. 최대 32자를 사용할 수 있습니다. 패키지를 식별하기 위해 Configuration Manager는 언어, 제조업체, 이름 및 버전 매개 변수를 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MifFileName

패키지 상태를 포함하는 MIF(관리 정보 형식) 파일의 이름을 지정합니다. 파일 이름 확장명은 이어야 .mif합니다. 상태 MIF 파일을 사용하여 자세한 상태 보고를 생성합니다. 상태 MIF 파일을 생성하려면 애플리케이션에서 InstallStatusMIF 함수를 호출해야 합니다. 자세한 내용은 상태 MIF 함수를 참조하세요.

이 매개 변수를 설정하는 경우 클라이언트가 배포를 실행할 때 Configuration Manager 클라이언트는 디렉터리 또는 %windir% 디렉터리에서 %TEMP% 지정한 설치 상태 MIF 파일을 찾습니다. 설치 상태는 프로그램이 성공적으로 실행되었는지 여부를 나타냅니다.

클라이언트가 파일을 찾지 못하면 해당 디렉터리의 모든 MIF 파일을 검색합니다. MifName, MifPublisher 및 MifVersion에 대해 지정한 값과 MIF 파일이 지정하는 값을 대/소문자를 구분하지 않습니다. 클라이언트가 일치하는 항목을 찾으면 MIF 파일이 프로그램의 설치 상태로 지정하는 상태를 사용합니다. 일치하는 항목을 찾을 수 없거나 MifFileName을 지정하지 않으면 클라이언트는 프로그램 종료 코드를 사용하여 프로그램의 설치 상태를 설정합니다. 종료 코드가 0이면 프로그램이 성공적으로 실행되었음을 나타냅니다. 다른 값은 애플리케이션별 오류 코드를 나타냅니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MifName

최대 50자까지 MIF 일치를 위해 패키지의 이름을 지정합니다. 자세한 내용은 MifFileName 매개 변수를 참조하세요.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MifPublisher

최대 32자까지 MIF 일치를 위해 패키지의 소프트웨어 게시자를 지정합니다. 자세한 내용은 MifFileName 매개 변수를 참조하세요.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MifVersion

MIF 일치를 위한 패키지의 버전 번호를 최대 32자까지 지정합니다. 자세한 내용은 MifFileName 매개 변수를 참조하세요.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MulticastAllow

이 패키지를 멀티캐스트를 통해 전송할 수 있도록 이 매개 변수를 $true 설정합니다. 자세한 내용은 멀티캐스트를 사용하여 Configuration Manager를 사용하여 네트워크를 통해 Windows 배포를 참조하세요.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MulticastEncrypt

MulticastAllow를 사용하도록 설정하는 경우 이 매개 변수를 $true 설정하여 멀티캐스트 패키지를 암호화합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MulticastTransferOnly

MulticastAllow를 사용하도록 설정하는 경우 멀티캐스트를 통해서만 이 드라이버 패키지를 전송하도록 이 매개 변수를 $true 설정합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

패키지 이름을 지정합니다. 최대 250자를 사용할 수 있습니다. 패키지를 식별하기 위해 Configuration Manager는 언어, 제조업체, 이름 및 버전 매개 변수를 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NewName

이 매개 변수를 사용하여 패키지 이름을 바꿉니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PassThru

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Path

패키지에 원본 파일이 포함된 경우 파일의 위치를 지정합니다. 사이트 서버에서 전체 로컬 경로 또는 네트워크 경로를 지정할 수 있습니다. 이 위치에 스크립트를 포함하여 프로그램이 실행해야 하는 모든 파일 및 하위 디렉터리가 포함되어 있는지 확인합니다.

형식:	String
별칭:	PackageSourcePath
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PersistContentInCache

이 패키지의 콘텐츠가 클라이언트 캐시에서 사용 중단되어 다른 콘텐츠의 공간을 확보하지 않으려면 이 매개 변수를 $true 설정하여 클라이언트 캐시에 유지합니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PrestageBehavior

사전 준비된 콘텐츠에 배포 지점을 사용하도록 설정할 때 동작을 지정합니다.

• ManualCopy: 이 패키지의 콘텐츠를 배포 지점에 수동으로 복사
• DownloadDelta: 배포 지점에 콘텐츠 변경 내용만 다운로드
• OnDemand: 패키지가 배포 지점에 할당되면 자동으로 콘텐츠 다운로드

자세한 내용은 사전 준비된 콘텐츠 사용을 참조하세요.

형식:	PrestageBehavior
허용되는 값:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Priority

사이트에서 콘텐츠를 다른 사이트와 이 사이트의 배포 지점으로 보내는 순서를 지정합니다.

사이트는 우선 순위가 높거나 우선 순위가 낮은 패키지 전에 높은 우선 순위 콘텐츠를 보냅니다. 우선 순위가 같은 패키지는 생성된 순서대로 전송됩니다.

형식:	Priorities
별칭:	DistributionPriority
허용되는 값:	High, Normal, Low
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-SendToPreferredDistributionPoint

기본 배포 지점에 주문형 콘텐츠 배포를 사용하도록 설정하려면 이 매개 변수를 $true 설정합니다. 이 설정을 사용하도록 설정하면 클라이언트가 패키지에 대한 콘텐츠를 요청하고 배포 지점에서 콘텐츠를 사용할 수 없는 경우 관리 지점에서 콘텐츠를 배포합니다. 자세한 내용은 주문형 콘텐츠 배포를 참조하세요.

형식:	Boolean
별칭:	SendToPreferredDistributionPoints
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Version

소프트웨어의 버전 번호를 지정합니다. 이 문자열의 최대 길이는 32자입니다. 패키지를 식별하기 위해 Configuration Manager는 언어, 제조업체, 이름 및 버전 매개 변수를 사용합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

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

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

관련 링크

• Export-CMPackage
• Get-CMPackage
• Import-CMPackage
• New-CMPackage
• Remove-CMPackage
• Configuration Manager의 패키지 및 프로그램