New-CMApplicationDeployment
응용 프로그램 배포를 만들 수 있습니다.
Syntax
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: 응용 프로그램 설치
이 명령은 2019년 2019년을 위한 새 배포를 개발자 Visual Studio 컬렉션에 만듭니다. 앱을 설치하며 필수입니다. 사용 가능한 날짜와 기한은 모두 과거와 동일하기 때문에 클라이언트가 이 정책을 받는 즉시 앱이 설치됩니다.
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
이 매개 변수를 사용하여 응용 프로그램에 대한 배포를 만들 때 복구 응용 프로그램 옵션을 구성합니다.
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApprovalRequired
이 매개 변수를 로 설정하면 관리자가 장치에서 이 응용 $true
프로그램에 대한 요청을 승인해야 합니다.
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCloseExecutable
버전 2107부터 이 매개 변수를 설정하여 응용 프로그램 배포 설정을 설치 $true
동작에 사용하도록 합니다. 그런 다음 Add-CMDeploymentTypeInstallBehavior cmdlet을 사용하여 설치가 성공할 수 있는 실행 파일이 실행되고 있지 않은지 확인할 수 있습니다.
이 매개 변수를 설정하여 다음과 같은 상황에서 이 $false
옵션을 사용하지 않도록 설정할 수 있습니다.
- Remove-CMDeploymentTypeInstallBehavior cmdlet을 사용하여 모든 실행 파일을 제거하는 경우
- 배포에서 실행 중인 실행을 확인하지는 않습니다.
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableDateTime
이 배포를 사용할 수 있는 경우 DateTime 개체를 지정합니다. 이 개체를 얻습니다. Get-Date 기본 제공 cmdlet을 사용합니다.
DeadlineDateTime을 사용하여 배포 할당 또는 마감일을 지정합니다.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
응용 프로그램을 배포할 컬렉션 개체를 지정합니다. 이 개체를 얻습니다. Get-CMCollection cmdlet을 사용합니다.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
이 응용 프로그램을 배포할 컬렉션의 ID를 지정합니다. 예를 들면 "SMS00004"
와 같습니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
이 응용 프로그램을 배포할 컬렉션의 이름을 지정합니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
이 배포에 대한 설명(옵션)을 지정합니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineDateTime
이 배포가 할당된 시간(마감일)에 대한 DateTime 개체를 지정합니다. 이 개체를 얻습니다. Get-Date 기본 제공 cmdlet을 사용합니다.
-AvailableDateTime을 사용하여 배포를 사용할 수 있는 시간을 지정합니다.
Type: | DateTime |
Aliases: | SupersedenceDeadlineDateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployAction
응용 프로그램을 설치하거나 제거하려면 배포 작업을 지정합니다. 경쟁 배포가 동일한 디바이스를 대상으로 하는 경우 설치 작업이 우선합니다.
Type: | DeployActionType |
Accepted values: | Install, Uninstall |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
배포 목적을 지정합니다.
Available
: 사용자가 소프트웨어 센터에서 응용 프로그램을 볼 수 있습니다. 필요한 경우 설치할 수 있습니다.Required
: 클라이언트는 설정한 일정에 따라 자동으로 앱을 설치합니다. 응용 프로그램이 숨겨져 있지 않은 경우 사용자는 배포 상태를 추적할 수 있습니다. 또한 소프트웨어 센터를 사용하여 마감일 전에 응용 프로그램을 설치할 수 있습니다.
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableContentDependencyDetection
종속 앱에 대한 콘텐츠를 자동으로 배포하지 못하게 이 매개 변수를 추가합니다.
Type: | SwitchParameter |
Aliases: | DisableDetectAssociatedContentDependencies |
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 |
-DistributeCollectionName
이 사이트는 이 컬렉션 이름과 연결된 배포 지점에 콘텐츠를 배포합니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeContent
먼저 앱 콘텐츠를 배포해야 하는 경우 이 매개 변수를 추가합니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
응용 프로그램 콘텐츠를 배포하기 위해 배포 지점 그룹의 이름을 지정합니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
응용 프로그램 콘텐츠를 배포할 경우 배포 지점의 이름을 지정합니다.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
이 배포에 대해 System Center Operations Manager 유지 관리 모드를 사용하도록 설정하려면 이 매개 $true
변수를 설정하십시오.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
이 매개 변수를 $true
설정하여 지연된 적용을 사용하도록 설정할 수 있습니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailParameterValue
경고를 발생하게 하는 응용 프로그램 설치 실패 비율을 지정합니다.
1에서 100까지의 정수 지정
이 경고를 사용하도록 설정하려면 CreatAlertBaseOnPercentFailure 매개 변수를 로 설정해야 $True
합니다.
Type: | Int32 |
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 |
-GenerateScomAlertOnFailure
클라이언트가 응용 프로그램을 설치하지 못하는 경우 Operations Manager 경고를 만들지 여부를 나타냅니다.
Type: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
배포할 응용 프로그램의 ID를 지정합니다.
Type: | Int32 |
Aliases: | CIId, CI_ID, ApplicationId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
배포할 응용 프로그램 개체를 지정합니다. 이 개체를 얻습니다. Get-CMApplication cmdlet을 사용합니다.
Type: | IResultObject |
Aliases: | Application |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
배포할 응용 프로그램의 이름을 지정합니다.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OverrideServiceWindow
유지 관리 기간 외부에서 예약된 경우에도 배포가 실행됩니다.
유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다.
이 값이 인 경우 예약된 시간이 유지 관리 기간 외부에 있는 경우에도 Configuration Manager에서 응용 $True
프로그램을 배포합니다.
이 값이 인 경우 Configuration Manager는 창 외부에 $False
응용 프로그램을 배포하지 않습니다. 사용 가능한 창에 배포할 수 있습니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
포함된 장치에 대해 쓰기 필터를 사용하도록 설정할지 여부를 나타냅니다.
값 의 경우 장치는 유지 관리 기간 동안 $True
변경 내용을 커밋합니다. 이 작업을 수행하려면 다시 시작해야 합니다.
값 의 경우 장치는 오버레이의 변경 내용을 저장하고 나중에 $False
커밋합니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDeploy
사용자의 기본 디바이스에 응용 프로그램을 미리 배포할지 여부를 나타냅니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RebootOutsideServiceWindow
컴퓨터가 유지 관리 기간 외부에서 다시 시작될지 여부를 나타냅니다.
유지 관리 기간은 컴퓨터 유지 관리 및 업데이트에 사용되는 지정된 기간입니다.
이 값이 인 경우 유지 관리 기간에 관계없이 필요한 $True
다시 시작이 실행됩니다.
이 값이 인 경우 컴퓨터가 유지 관리 기간 외부에서 $False
다시 시작되지 않습니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplaceToastNotificationWithDialog
클라이언트에서 필요한 소프트웨어를 사용할 수 있는 경우 이 매개 변수를 설정하여 기본 알림 메시지를 대화 상자 창으로 $true
바꾸십시오. 기본적으로 false입니다. 자세한 내용은 알림 메시지를 대화 창으로 바꾸기 를 참조하세요.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
배포를 시작하기 전에 컴퓨터에 절전 모드 해제 패킷을 보낼지 여부를 나타냅니다.
이 값이 인 경우 Configuration Manager는 절전 모드 $True
해제를 시도합니다.
이 값이 인 경우 컴퓨터를 절전 모드로 $False
해제하지 않습니다.
컴퓨터를 절전 모드로 해제하려면 먼저 Wake On LAN을 구성해야 합니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Simulation
이 매개 변수를 추가하여 배포 시뮬레이션을 만들 수 있습니다. 자세한 내용은 Configuration Manager를 사용하여 응용 프로그램 배포 시뮬레이트를 참조하세요.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessParameterValue
경고를 발생하게 하는 성공적인 응용 프로그램 설치 비율을 지정합니다.
0에서 99까지의 정수 지정
이 경고를 사용하도록 설정하려면 CreateAlertBaseOnPercentSuccess 매개 변수를 로 설정해야 $True
합니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
사용할 표준 시간대를 지정합니다.
LocalTime
: 현지 시간을 사용 합니다.UTC
: UTC(협정 세계시)를 사용
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateSupersedence
사용 가능한 배포의 경우 이 매개 변수를 사용하여 업그레이드된 응용 프로그램이 설치된 사용자 또는 장치를 업그레이드할 설치 기한을 지정합니다. DeadlineDateTime을 사용하여 특정 시간을 지정합니다. 그렇지 않으면 AvailableDateTime이후 최대한 빨리 지정합니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
마감일 이후에 클라이언트가 데이터 요금제 인터넷 연결을 통해 콘텐츠를 다운로드할 수 있도록 허용할지 여부를 나타냅니다. 이 경우 추가 비용도 부과될 수 있습니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
사용자 알림 유형을 지정합니다.
DisplayAll
: 소프트웨어 센터에 표시하고 모든 알림을 표시합니다.DisplaySoftwareCenterOnly
: 소프트웨어 센터에 표시하고 컴퓨터 다시 시작 알림만 표시합니다.HideAll
: 소프트웨어 센터 및 모든 알림에서 숨기기.
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. 이 cmdlet은 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object