Share via


Set-CMApplicationDeployment

애플리케이션 배포 구성

Syntax

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

애플리케이션에 대한 배포를 만들 때 이 매개 변수를 사용하여 애플리케이션 복구 옵션을 구성합니다.

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

-ApplicationId

애플리케이션의 ID를 지정합니다.

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

-ApplicationName

애플리케이션의 이름을 지정합니다.

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

-AutoCloseExecutable

버전 2107부터 설치 동작에 $true 애플리케이션 배포 설정을 사용하도록 설정하려면 이 매개 변수를 로 설정합니다. 그런 다음 Add-CMDeploymentTypeInstallBehavior cmdlet을 사용하여 설치가 성공하기 위해 실행되고 있지 않은지 확인할 실행 파일을 추가합니다.

다음 상황에서 이 옵션을 사용하지 않도록 설정하려면 이 매개 변수 $false 를 로 설정합니다.

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

-AvailableDateTime

이 배포를 사용할 수 있는 시기에 DateTime 개체를 지정합니다. 이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.

DeadlineDateTime을 사용하여 배포 할당 또는 최종 기한을 지정합니다.

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

-Collection

애플리케이션이 배포되는 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection cmdlet을 사용합니다.

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

-CollectionId

애플리케이션이 배포되는 컬렉션의 ID를 지정합니다. 예를 들면 "SMS00004"와 같습니다.

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

-CollectionName

애플리케이션이 배포되는 컬렉션의 이름을 지정합니다.

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

-Comment

배포에 대한 선택적 주석을 지정합니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-CreateAlertBaseOnPercentFailure

배포에 실패한 애플리케이션의 백분율에 대한 경고를 만들지 여부를 나타냅니다. 백분율 값을 지정하려면 FailParameterValue 매개 변수를 사용합니다.

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

-CreateAlertBaseOnPercentSuccess

성공적으로 배포된 애플리케이션의 백분율에 대한 경고를 만들지 여부를 나타냅니다. 백분율 값을 지정하려면 SuccessParameterValue 매개 변수를 사용합니다.

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

-DeadlineDateTime

이 배포를 할당할 때 최종 기한이라고도 하는 DateTime 개체를 지정합니다. 이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.

-AvailableDateTime을 사용하여 배포를 사용할 수 있는 시기를 지정합니다.

Type:DateTime
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

-EnableMomAlert

이 배포에 $true System Center Operations Manager 유지 관리 모드를 사용하도록 설정하려면 이 매개 변수를 로 설정합니다.

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

-EnableSoftDeadline

이 매개 변수를 로 $true 설정하여 지연된 적용을 사용하도록 설정합니다.

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

-FailParameterValue

경고를 발생시키는 실패한 애플리케이션 설치의 백분율을 지정합니다. 1에서 100까지의 정수를 지정합니다. 이 경고를 사용하도록 설정하려면 CreatAlertBaseOnPercentFailure 매개 변수를 로 $True설정합니다.

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

-ForceWildcardHandling

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

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

-InputObject

구성할 애플리케이션 배포 개체를 지정합니다. 이 개체를 얻으려면 Get-CMApplicationDeployment cmdlet을 사용합니다.

Type:IResultObject
Aliases:Application, DeploymentSummary, Assignment
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-OverrideServiceWindow

유지 관리 기간 외부에서 예약된 경우에도 배포가 이루어지는지 여부를 나타냅니다. 유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다. 이 값이 이$True면 예약된 시간이 유지 관리 기간을 벗어나더라도 Configuration Manager 애플리케이션을 배포합니다. 이 값이 이$False면 Configuration Manager 창 외부에 애플리케이션을 배포하지 않습니다. 사용 가능한 창에 배포할 수 있게 될 때까지 기다립니다.

Type:Boolean
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

-PersistOnWriteFilterDevice

포함된 디바이스에 쓰기 필터를 사용할지 여부를 나타냅니다. 값의 $True경우 디바이스는 유지 관리 기간 동안 변경 내용을 커밋합니다. 이 작업을 수행하려면 다시 시작해야 합니다. 값의 $False경우 디바이스는 오버레이에 변경 내용을 저장하고 나중에 커밋합니다.

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

-PostponeDateTime

CreateAlertBaseOnPercentSuccess를$true로 설정하면 이 매개 변수를 사용하여 DateTime 개체를 지정합니다. Configuration Manager 임계값이 이 날짜 이후의 SuccessParameterValue보다 낮으면 배포 경고를 만듭니다.

이 개체를 얻으려면 Get-Date 기본 제공 cmdlet을 사용합니다.

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

-PreDeploy

애플리케이션을 사용자의 기본 디바이스에 미리 배포할지 여부를 나타냅니다.

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

-RaiseMomAlertsOnFailure

클라이언트가 애플리케이션을 설치하지 못하는 경우 Operations Manager 경고를 만들지 여부를 나타냅니다.

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

-RebootOutsideServiceWindow

컴퓨터가 유지 관리 기간 외부에서 다시 시작되는지 여부를 나타냅니다. 유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다. 이 값이 이 $True면 유지 관리 기간과 관계없이 필요한 모든 다시 시작이 수행됩니다. 이 값이 이 $False면 컴퓨터가 유지 관리 기간 외부에서 다시 시작되지 않습니다.

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

-ReplaceToastNotificationWithDialog

클라이언트에서 필요한 소프트웨어를 사용할 수 있는 경우 이 매개 변수를 로 $true 설정하여 기본 알림 메시지를 대화 상자 창으로 바꿉니다. 기본적으로 false입니다. 자세한 내용은 알림 메시지를 대화 상자 창으로 바꾸기를 참조하세요.

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

-RequireApproval

이 매개 변수를 $true로 설정하면 관리자가 디바이스에서 이 애플리케이션에 대한 요청을 승인해야 합니다.

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

-SendWakeUpPacket

배포가 시작되기 전에 컴퓨터에 절전 모드 해제 패킷을 보낼지 여부를 나타냅니다. 이 값이 이$True면 Configuration Manager 컴퓨터를 절전 모드에서 해제하려고 시도합니다. 이 값이 이 $False면 컴퓨터를 절전 모드에서 해제하지 않습니다. 컴퓨터가 절 해제하려면 먼저 Wake On LAN을 구성해야 합니다.

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

-SuccessParameterValue

경고를 발생시키는 성공적인 애플리케이션 설치의 백분율을 지정합니다. 0에서 99까지의 정수를 지정합니다. 이 경고를 사용하도록 설정하려면 CreateAlertBaseOnPercentSuccess 매개 변수를 로 $True설정합니다.

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

-TimeBaseOn

사용할 표준 시간대를 지정합니다.

  • LocalTime: 현지 시간을 사용합니다.
  • UTC: UTC(협정 세계시)를 사용합니다.
Type:TimeType
Accepted values:LocalTime, Utc
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseMeteredNetwork

최종 기한 이후에 클라이언트가 요금제 인터넷 연결을 통해 콘텐츠를 다운로드할 수 있도록 허용할지 여부를 나타내며, 이로 인해 추가 비용이 발생할 수 있습니다.

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

-UserNotification

사용자 알림 유형을 지정합니다.

  • DisplayAll: 소프트웨어 센터에 표시하고 모든 알림을 표시합니다.
  • DisplaySoftwareCenterOnly: 소프트웨어 센터에 표시하고 컴퓨터 다시 시작 알림만 표시합니다.
  • HideAll: 소프트웨어 센터 및 모든 알림에서 숨깁니다.
Type:UserNotificationType
Accepted values:DisplayAll, DisplaySoftwareCenterOnly, HideAll
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

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_ApplicationAssignment 서버 WMI 클래스를 참조하세요.