New-CMApplicationDeployment

모듈:

ConfigurationManager

애플리케이션 배포를 만듭니다.

구문

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMApplicationDeployment cmdlet은 애플리케이션 배포를 만듭니다. 자세한 내용은 Configuration Manager를 사용하여 애플리케이션 배포를 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 애플리케이션 설치

이 명령은 개발자 워크스테이션 컬렉션에 Visual Studio 2019에 대한 새 배포를 만듭니다. 앱을 설치하고 필수입니다. 사용 가능한 날짜와 마감일은 모두 과거와 동일하므로 클라이언트가 이 정책을 수신하는 즉시 앱을 설치합니다.

New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required

매개 변수

-AllowRepairApp

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

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

-ApprovalRequired

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

형식:	Boolean
별칭:	AppRequiresApproval
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	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:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeadlineDateTime

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

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

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

-DeployAction

애플리케이션을 설치하거나 제거할 배포 작업을 지정합니다. 경쟁 배포가 동일한 디바이스를 대상으로 하는 경우 설치 작업이 우선합니다.

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

-DeployPurpose

배포 목적을 지정합니다.

• Available: 사용자가 소프트웨어 센터에서 애플리케이션을 봅니다. 요청 시 설치할 수 있습니다.

• Required: 클라이언트는 설정한 일정에 따라 앱을 자동으로 설치합니다. 애플리케이션이 숨겨지지 않은 경우 사용자는 배포 상태를 추적할 수 있습니다. 또한 소프트웨어 센터를 사용하여 최종 기한 전에 애플리케이션을 설치할 수도 있습니다.

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

-DisableContentDependencyDetection

종속 앱에 대한 콘텐츠를 자동으로 배포하지 않도록 이 매개 변수를 추가합니다.

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

-DisableWildcardHandling

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

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

-DistributeCollectionName

사이트는 이 컬렉션 이름과 연결된 배포 지점에 콘텐츠를 배포합니다.

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

-DistributeContent

먼저 앱 콘텐츠를 배포해야 하는 경우 이 매개 변수를 추가합니다.

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

-DistributionPointGroupName

애플리케이션 콘텐츠를 배포하려면 배포 지점 그룹의 이름을 지정합니다.

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

-DistributionPointName

애플리케이션 콘텐츠를 배포하려면 배포 지점의 이름을 지정합니다.

형식:	String
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

-GenerateScomAlertOnFailure

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

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

-Id

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

형식:	Int32
별칭:	CIId, CI_ID, ApplicationId
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-InputObject

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

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

-Name

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

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

-OverrideServiceWindow

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

형식:	Boolean
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

-RebootOutsideServiceWindow

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

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

-ReplaceToastNotificationWithDialog

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

형식:	Boolean
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

-Simulation

이 매개 변수를 추가하여 배포 시뮬레이션을 만듭니다. 자세한 내용은 Configuration Manager를 사용하여 애플리케이션 배포 시뮬레이션을 참조하세요.

형식:	SwitchParameter
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

-UpdateSupersedence

사용 가능한 배포의 경우 이 매개 변수를 사용하여 대체된 애플리케이션이 설치된 사용자 또는 디바이스를 업그레이드할 설치 최종 기한을 지정합니다. DeadlineDateTime을 사용하여 특정 시간을 지정합니다. 그렇지 않으면 AvailableDateTime 이후에 가능한 한 빨리 지정합니다.

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

관련 링크

• Get-CMApplication
• Get-CMApplicationDeployment
• Remove-CMApplicationDeployment
• Set-CMApplicationDeployment
• Configuration Manager를 사용하여 애플리케이션 배포