Set-CMApplicationDeployment
애플리케이션 배포 구성
구문
Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
-InputObject <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationId <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationName <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-CMApplicationDeployment cmdlet은 Configuration Manager에서 애플리케이션 배포의 속성을 수정합니다. 자세한 내용은 Configuration Manager를 사용하여 애플리케이션 배포를 참조하세요.
수정할 애플리케이션 배포를 지정하려면 컬렉션 이름과 애플리케이션을 지정합니다. 이름 또는 ID로 애플리케이션을 지정할 수 있습니다. Get-CMApplication cmdlet을 사용하여 수정할 애플리케이션을 가져올 수도 있습니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: 애플리케이션 배포의 가용성 및 최종 기한 수정
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)이 명령은 모든 사용자라는 컬렉션에 대해 Track System 2011이라는 애플리케이션에 대한 애플리케이션 배포를 수정합니다. 명령은 애플리케이션을 사용할 수 있는 현재 날짜를 지정합니다. 또한 향후 30일 동안 배포 기한을 구성합니다.
매개 변수
-AllowRepairApp
애플리케이션에 대한 배포를 만들 때 이 매개 변수를 사용하여 애플리케이션 복구 옵션을 구성합니다.
| 형식: | Boolean |
| 별칭: | AllowUserRepairApplication |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ApplicationId
애플리케이션의 ID를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ApplicationName
애플리케이션의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AutoCloseExecutable
버전 2107부터 설치 동작에 $true 애플리케이션 배포 설정을 사용하도록 설정하려면 이 매개 변수를 로 설정합니다. 그런 다음 Add-CMDeploymentTypeInstallBehavior cmdlet을 사용하여 설치가 성공하기 위해 실행되고 있지 않은지 확인할 실행 파일을 추가합니다.
다음 상황에서 이 옵션을 사용하지 않도록 설정하려면 이 매개 변수 $false 를 로 설정합니다.
- Remove-CMDeploymentTypeInstallBehavior cmdlet을 사용하여 모든 실행 파일 제거
- 배포에서 실행 파일을 실행 중으로 확인하지 않도록 합니다.
| 형식: | Boolean |
| 별칭: | AutoCloseExeOnInstallBehavior |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AvailableDateTime
이 배포를 사용할 수 있는 시기에 DateTime 개체를 지정합니다. 이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.
DeadlineDateTime을 사용하여 배포 할당 또는 마감일을 지정합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Collection
애플리케이션이 배포되는 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CollectionId
애플리케이션이 배포되는 컬렉션의 ID를 지정합니다. 예를 들면 "SMS00004"와 같습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CollectionName
애플리케이션이 배포되는 컬렉션의 이름을 지정합니다.
| 형식: | 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 |
-CreateAlertBaseOnPercentFailure
배포에 실패한 애플리케이션의 백분율에 대한 경고를 만들지 여부를 나타냅니다. 백분율 값을 지정하려면 FailParameterValue 매개 변수를 사용합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CreateAlertBaseOnPercentSuccess
성공적으로 배포된 애플리케이션의 백분율에 대한 경고를 만들지 여부를 나타냅니다. 백분율 값을 지정하려면 SuccessParameterValue 매개 변수를 사용합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DeadlineDateTime
이 배포를 할당할 때 최종 기한이라고도 하는 DateTime 개체를 지정합니다. 이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.
-AvailableDateTime을 사용하여 배포를 사용할 수 있는 시기를 지정합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableMomAlert
이 배포에 $true System Center Operations Manager 유지 관리 모드를 사용하도록 설정하려면 이 매개 변수를 로 설정합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableSoftDeadline
이 매개 변수를 로 $true 설정하여 지연된 적용을 사용하도록 설정합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FailParameterValue
경고를 발생시키는 실패한 애플리케이션 설치의 백분율을 지정합니다.
1에서 100까지의 정수를 지정합니다.
이 경고를 사용하도록 설정하려면 CreatAlertBaseOnPercentFailure 매개 변수를 로 $True설정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
구성할 애플리케이션 배포 개체를 지정합니다. 이 개체를 얻으려면 Get-CMApplicationDeployment cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | Application, DeploymentSummary, Assignment |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-OverrideServiceWindow
유지 관리 기간 외부에서 예약된 경우에도 배포가 이루어지는지 여부를 나타냅니다.
유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다.
이 값이 인 경우 Configuration Manager는 $True예약된 시간이 유지 관리 기간을 벗어나더라도 애플리케이션을 배포합니다.
이 값이 인 $False경우 Configuration Manager는 창 외부에 애플리케이션을 배포하지 않습니다. 사용 가능한 창에 배포할 수 있게 될 때까지 기다립니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | 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 |
-PostponeDateTime
CreateAlertBaseOnPercentSuccess를$true로 설정하면 이 매개 변수를 사용하여 DateTime 개체를 지정합니다. 이 날짜 이후 임계값이 SuccessParameterValue 보다 낮으면 Configuration Manager에서 배포 경고를 만듭니다.
이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PreDeploy
애플리케이션을 사용자의 기본 디바이스에 미리 배포할지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RaiseMomAlertsOnFailure
클라이언트가 애플리케이션을 설치하지 못하는 경우 Operations Manager 경고를 만들지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RebootOutsideServiceWindow
컴퓨터가 유지 관리 기간 외부에서 다시 시작되는지 여부를 나타냅니다.
유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다.
이 값이 이 $True면 유지 관리 기간과 관계없이 필요한 모든 다시 시작이 수행됩니다.
이 값이 이 $False면 컴퓨터가 유지 관리 기간 외부에서 다시 시작되지 않습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ReplaceToastNotificationWithDialog
클라이언트에서 필요한 소프트웨어를 사용할 수 있는 경우 이 매개 변수를 로 $true 설정하여 기본 알림 메시지를 대화 상자 창으로 바꿉니다. 기본적으로 false입니다. 자세한 내용은 알림 메시지를 대화 상자 창으로 바꾸기를 참조하세요.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequireApproval
이 매개 변수를 $true로 설정하면 관리자가 디바이스에서 이 애플리케이션에 대한 요청을 승인해야 합니다.
| 형식: | Boolean |
| 별칭: | AppRequiresApproval |
| 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 |
-SuccessParameterValue
경고를 발생시키는 성공적인 애플리케이션 설치의 백분율을 지정합니다.
0에서 99까지의 정수를 지정합니다.
이 경고를 사용하도록 설정하려면 CreateAlertBaseOnPercentSuccess 매개 변수를 로 $True설정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimeBaseOn
사용할 표준 시간대를 지정합니다.
-
LocalTime: 현지 시간을 사용합니다. -
UTC: UTC(협정 세계시)를 사용합니다.
| 형식: | TimeType |
| 허용되는 값: | LocalTime, Utc |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseMeteredNetwork
최종 기한 이후에 클라이언트가 요금제 인터넷 연결을 통해 콘텐츠를 다운로드할 수 있도록 허용할지 여부를 나타내며, 이로 인해 추가 비용이 발생할 수 있습니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UserNotification
사용자 알림 유형을 지정합니다.
-
DisplayAll: 소프트웨어 센터에 표시하고 모든 알림을 표시합니다. -
DisplaySoftwareCenterOnly: 소프트웨어 센터에 표시하고 컴퓨터 다시 시작 알림만 표시합니다. -
HideAll: 소프트웨어 센터 및 모든 알림에서 숨깁니다.
| 형식: | UserNotificationType |
| 허용되는 값: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| 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
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_ApplicationAssignment 서버 WMI 클래스를 참조하세요.