Set-CMPackage

참조

모듈:: ConfigurationManager

패키지를 수정합니다.

Syntax

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을 실행하기 전에 확인 메시지를 표시하기 위해 이 매개 변수를 추가합니다.

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

-CopyToPackageShareOnDistributionPoint

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

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

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

-CustomPackageShareName

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

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

-Description

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

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

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

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

-DisconnectUserFromDistributionPointMins

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

Type:	UInt32
Aliases:	ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetry

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

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

-DistributionPointUpdateSchedule

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

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

-EnableBinaryDeltaReplication

BDR(이진 $true 복제)을 사용하도록 설정하려면 이 매개 변수를 이 매개 변수로 설정하십시오. 자세한 내용은 Configuration Manager의 콘텐츠 관리에 대한 기본 개념을 참조하세요.

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

-ForceWildcardHandling

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

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

-Id

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

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

-InputObject

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

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

-Language

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

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

-Manufacturer

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

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

-MifFileName

패키지 상태가 포함된 MIF(관리 정보 형식) 파일의 이름을 지정합니다. 파일 이름 확장명은 .mif 입니다. 상태 MIF 파일을 사용하여 자세한 상황 보고를 생성합니다. 상태 MIF 파일을 생성하려면 응용 프로그램에서 InstallStatusMIF 함수를 호출해야 합니다. 자세한 내용은 Status MIF Functions를 참조하십시오.

이 매개 변수를 설정하면 클라이언트가 배포를 실행하면 Configuration Manager 클라이언트가 지정한 설치 상태 MIF 파일의 디렉터리 또는 디렉터리를 %TEMP% %windir% 검색합니다. 설치 상태는 프로그램이 성공적으로 실행 지 여부를 나타냅니다.

클라이언트가 파일을 찾지 못하면 해당 폴더의 모든 MIF 파일을 검색합니다. MifName, MifPublisher및 MifVersion에 대해 지정한 값을 MIF 파일에서 지정한 값과 대소문자 비교할 수 없습니다. 클라이언트가 일치를 찾으면 MIF 파일이 프로그램의 설치 상태로 지정하는 상태를 사용하게 됩니다. 일치하는 이름을 찾을 수 없는 경우 또는 MifFileName을지정하지 않으면 클라이언트는 프로그램 종료 코드를 사용하여 프로그램의 설치 상태를 설정합니다. 종료 코드가 0이면 프로그램이 성공적으로 실행된 것입니다. 다른 값은 응용 프로그램별 오류 코드를 나타냅니다.

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

-MifName

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

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

-MifPublisher

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

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

-MifVersion

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

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

-MulticastAllow

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

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

-MulticastEncrypt

MulticastAllow를사용하도록 설정하는 경우 이 매개 변수를 멀티캐스트 $true 암호화하도록 설정하십시오.

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

-MulticastTransferOnly

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

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

-Name

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

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

-NewName

패키지 이름을 변경하는 데 이 매개 변수를 사용합니다.

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

-PassThru

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

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

-Path

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

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

-PersistContentInCache

이 패키지의 콘텐츠가 클라이언트 캐시에서 사용되지 않는 다른 콘텐츠를 만들 수 있도록 하려는 경우 이 매개 변수를 클라이언트 $true 유지로 설정하십시오. ****

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

-PrestageBehavior

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

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

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

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

-Priority

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

이 사이트에서는 보통 또는 낮은 우선 순위의 패키지보다 우선 순위가 높은 콘텐츠를 전송합니다. 우선 순위가 같은 패키지는 패키지가 만들어진 순서대로 전송됩니다.

Type:	Priorities
Aliases:	DistributionPriority
Accepted values:	High, Normal, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

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

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

-Version

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

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

-WhatIf

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

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

Share via