Set-CMPackageDeployment
Configuration Manager에서 소프트웨어 패키지를 배포하는 방법을 정의하는 값을 변경합니다.
구문
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-InputObject <IResultObject>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageName <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageId <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageId <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-InputObject <IResultObject>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-CMPackageDeployment cmdlet은 Configuration Manager가 소프트웨어 패키지를 배포하는 방법을 정의하는 값을 변경합니다. 배포에는 디바이스 또는 사용자 컬렉션, 배포할 패키지, 디바이스 프로그램 이름 또는 표준 프로그램 이름이 포함됩니다. 수정할 배포를 지정하려면 컬렉션 이름, 패키지 및 프로그램 이름을 지정합니다. 이름 또는 ID로 패키지를 지정하거나 Get-CMPackage cmdlet을 사용하여 패키지 개체를 가져올 수 있습니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 되풀이 속성 설정
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True이 명령은 All Systems라는 컬렉션, DPM이라는 디바이스 프로그램 및 Windows 8용 사용자 상태 마이그레이션 도구라는 패키지로 지정된 배포를 변경합니다. 명령은 UseRecurrencePattern 매개 변수를 $True 값으로 설정합니다. 명령은 재귀 단위 시간 및 재귀 값 7을 지정합니다. 따라서 배포는 7시간마다 되풀이됩니다.
예제 2: 가용성 날짜 및 시간 설정
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False이 명령은 All Systems라는 컬렉션, Windows 8용 사용자 상태 마이그레이션 도구라는 패키지 및 SPM이라는 표준 프로그램으로 지정된 배포를 변경합니다. 명령은 배포를 사용할 수 있게 되는 날짜와 시간을 지정합니다. 또한 명령은 배포가 가용성 일정에 UTC를 사용하지 않도록 지정합니다. 일정은 현지 표준 시간대를 나타냅니다.
매개 변수
-AllowFallback
{{ Fill AllowFallback Description }}
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AllowSharedContent
클라이언트가 공유 콘텐츠를 사용하는지 여부를 나타냅니다. 이 값이 $True 경우 클라이언트는 해당 콘텐츠를 다운로드한 다른 클라이언트에서 콘텐츠를 다운로드하려고 시도합니다. 이 값이 $False 경우 클라이언트는 다른 클라이언트에서 다운로드를 시도하지 않습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Collection
사용자 컬렉션을 지정합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CollectionId
디바이스 또는 사용자 컬렉션의 ID를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CollectionName
디바이스 또는 사용자 컬렉션의 ID를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-Comment
배포에 대한 주석을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DeploymentAvailableDateTime
DateTime 개체로 배포를 사용할 수 있게 되는 날짜와 시간을 지정합니다. DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DeploymentExpireDateTime
DateTime 개체로 배포가 만료되는 날짜와 시간을 지정합니다. DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DeploymentStartDateTime
DateTime 개체로 배포가 시작되는 날짜와 시간을 지정합니다. DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DeviceProgramName
디바이스 프로그램의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableExpireSchedule
일정이 배포를 만료하도록 설정할지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FastNetworkOption
빠른 네트워크에서 클라이언트 동작을 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
| 형식: | FastNetworkOptionType |
| 허용되는 값: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
패키지 개체를 지정합니다.
| 형식: | IResultObject |
| 별칭: | Package, DeploymentSummary, Advertisement |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PackageId
패키지의 ID를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PackageName
패키지의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PassThru
현재 작업 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PersistOnWriteFilterDevice
포함된 디바이스에 쓰기 필터를 사용할지 여부를 나타냅니다. $True 값의 경우 디바이스는 유지 관리 기간 동안 변경 내용을 커밋합니다. 이 작업을 수행하려면 다시 시작해야 합니다. $False 값의 경우 디바이스는 오버레이에 변경 내용을 저장하고 나중에 커밋합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RecurUnit
되풀이 배포에 대한 단위를 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.
- 일
- 시간
- 분
| 형식: | RecurUnitType |
| 허용되는 값: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RecurValue
배포가 재귀되는 빈도를 지정합니다. 이 매개 변수는 RecurUnit 매개 변수에 지정된 단위 형식에 따라 달라집니다. 단위가 시간인 경우 이 값은 1에서 23 사이, 단위가 일인 경우 1에서 31 사이, 단위가 분인 경우 1에서 59 사이일 수 있습니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Rerun
배포가 다시 실행되는지 여부를 나타냅니다. 이 값이 $True 경우 RerunBehavior 매개 변수에 지정된 대로 클라이언트에 대해 배포가 다시 실행됩니다. 이 값이 $False 배포가 다시 실행되지 않습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RerunBehavior
클라이언트에서 배포가 다시 실행되는 방법을 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.
- AlwaysRerunProgram. 배포에 성공한 경우에도 예약된 대로 다시 실행합니다. 되풀이 배포에 이 값을 사용할 수 있습니다.
- NeverRerunDeployedProgram. 배포가 실패하거나 파일이 변경된 경우에도 다시 실행되지 않습니다.
- RerunIfFailedPreviousAttempt. 이전 시도에서 배포가 실패한 경우 예약된 대로 다시 실행합니다.
- RerunIfSucceededOnpreviousAttempt. 이전 시도가 성공한 경우에만 다시 실행합니다. 이 값은 이전 업데이트에 따라 달라지는 업데이트에 사용할 수 있습니다.
| 형식: | RerunBehaviorType |
| 허용되는 값: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RunFromSoftwareCenter
소프트웨어 센터에서 실행할지 여부를 나타냅니다.
| 형식: | Boolean |
| 별칭: | AllowUsersRunIndependently |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Schedule
CMSchedule 개체를 지정합니다. 일정은 유지 관리 기간이 발생하는 시기를 지정합니다. CMSchedule 개체를 만들려면 New-CMSchedule cmdlet을 사용합니다.
| 형식: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ScheduleEvent
일정 이벤트 형식의 배열을 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.
- AsSoonAsPossible
- LogOff
- LogOn
- SendWakeUpPacket
| 형식: | ScheduleEventType[] |
| 허용되는 값: | AsSoonAsPossible, LogOn, LogOff |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SendWakeupPacket
배포가 시작되기 전에 컴퓨터에 절전 모드 해제 패킷을 보낼지 여부를 나타냅니다. 이 값이 $True Configuration Manager는 컴퓨터를 절전 모드에서 해제합니다. 이 값이 $False 컴퓨터 절전 모드에서 해제되지 않습니다. 컴퓨터가 절 해제하려면 먼저 Wake On LAN을 구성해야 합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SlowNetworkOption
Configuration Manager가 느린 네트워크에서 이 패키지를 배포하는 방법을 지정합니다. 이 매개 변수에 사용할 수 있는 값은 다음과 같습니다.
- DoNotRunProgram
- DownloadContentFromDistributionPointAndLocally
- RunProgramFromDistributionPoint
| 형식: | SlowNetworkOptionType |
| 허용되는 값: | DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SoftwareInstallation
유지 관리 기간 외에 배포된 소프트웨어를 설치할지 여부를 나타냅니다. 유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다. 이 값이 $True 경우 일정이 유지 관리 기간을 벗어나더라도 Configuration Manager는 일정에 따라 소프트웨어를 설치합니다. 이 값이 $False 경우 Configuration Manager는 배포된 소프트웨어를 창 외부에 설치하지 않지만 유지 관리 기간을 기다립니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StandardProgramName
표준 프로그램 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SystemRestart
시스템이 유지 관리 기간 외부에서 다시 시작되는지 여부를 나타냅니다. 유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다. 이 값이 $True 유지 관리 기간과 관계없이 필요한 모든 다시 시작이 수행됩니다. 이 값이 $False 경우 컴퓨터는 유지 관리 기간 외부에서 다시 시작되지 않습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseRecurrencePattern
되풀이 패턴을 사용할지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseUtc
그리니치 표준시라고도 하는 UTC(협정 세계시)를 사용할지 여부를 나타냅니다. 이 값이 $True 경우 Configuration Manager는 이 배포에 UTC를 사용합니다. 이 값이 $False 경우 Configuration Manager는 현지 시간을 사용합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseUtcForAvailableSchedule
사용 가능한 일정에 UTC를 사용할지 여부를 나타냅니다. 이 값이 $True 경우 Configuration Manager는 UTC를 사용합니다. 이 값이 $False 경우 Configuration Manager는 현지 시간을 사용합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseUtcForExpireSchedule
만료 일정에 UTC를 사용할지 여부를 나타냅니다. 이 값이 $True 경우 Configuration Manager는 UTC를 사용합니다. 이 값이 $False 경우 Configuration Manager는 현지 시간을 사용합니다.
| 형식: | Boolean |
| 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