New-CMApplicationGroupDeployment

참조

모듈:: ConfigurationManager

애플리케이션 그룹에 대한 배포를 만듭니다.

구문

New-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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-CMApplicationGroupDeployment
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-EnableMomAlert <Boolean>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-TimeBaseOn <TimeType>]
   [-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

애플리케이션 그룹에 대한 배포를 만듭니다. 앱 그룹에는 여러 애플리케이션이 포함되며 사용자는 소프트웨어 센터의 그룹을 단일 엔터티로 봅니다. 자세한 내용은 애플리케이션 그룹 만들기를 참조하세요.

앱 그룹을 배포하려면 앱 그룹을 만들어야 합니다. 그런 다음 사용자 또는 디바이스 컬렉션에 단일 배포로 배포할 수 있습니다.

참고

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

예제

예 1

$collection = Get-CMCollection -Name "co1"

$distributionPointName = "dp1.contoso.com"

New-CMApplicationGroupDeployment -Id 16777536 -Collection $collection -DistributionPointName $distributionPointName -DistributeContent

매개 변수

-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를 이 앱 그룹 배포의 대상으로 지정합니다.

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

사용자가 이 배포를 설치할 수 있는지, 아니면 최종 기한에 설치해야 하는지를 지정합니다.

형식:	DeployPurposeType
허용되는 값:	Available, Required
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

-ForceWildcardHandling

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

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

-GenerateScomAlertOnFailure

배포가 실패할 $true 때 System Center Operations Manager 경고를 생성하려면 이 매개 변수를 로 설정합니다.

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

-Id

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

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

-InputObject

앱 그룹에 대한 개체를 지정합니다. 이 개체를 얻으려면 Get-CMApplicationGroup cmdlet을 사용합니다.

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

-Name

이 앱 그룹 배포의 이름을 지정합니다.

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

-OverrideServiceWindow

유지 관리 기간 외부에 앱 그룹을 설치하려면 이 매개 변수 $true 를 로 설정합니다.

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

-PersistOnWriteFilterDevice

이 매개 변수를 사용하여 Windows Embedded 디바이스에 대한 쓰기 필터를 처리합니다. 로 설정 $true하면 디바이스는 최종 기한 또는 유지 관리 기간 동안 변경 내용을 커밋합니다. 이 작업을 수행하려면 다시 시작해야 합니다. 로 설정 $false하면 디바이스는 임시 오버레이에 변경 내용을 저장하고 나중에 커밋합니다.

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

-RebootOutsideServiceWindow

디바이스가 $true 유지 관리 기간 외부에서 다시 시작되도록 하려면 이 매개 변수를 로 설정합니다.

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

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

참고

이 cmdlet은 SMS_ApplicationGroupAssignment WMI 클래스 개체를 반환합니다.

다음을 통해 공유

New-CMApplicationGroupDeployment

구문

Description

예제

예 1

매개 변수

-AvailableDateTime

-Collection

-CollectionId

-CollectionName

-Comment

-Confirm

-DeadlineDateTime

-DeployAction

-DeployPurpose

-DisableWildcardHandling

-DistributeCollectionName

-DistributeContent

-DistributionPointGroupName

-DistributionPointName

-EnableMomAlert

-ForceWildcardHandling

-GenerateScomAlertOnFailure

-Id

-InputObject

-Name

-OverrideServiceWindow

-PersistOnWriteFilterDevice

-RebootOutsideServiceWindow

-SendWakeupPacket

-TimeBaseOn

-UseMeteredNetwork

-UserNotification

-WhatIf

입력

출력

참고

피드백

추가 리소스

다음을 통해 공유

New-CMApplicationGroupDeployment

구문

Description

예제

예 1

매개 변수

-AvailableDateTime

-Collection

-CollectionId

-CollectionName

-Comment

-Confirm

-DeadlineDateTime

-DeployAction

-DeployPurpose

-DisableWildcardHandling

-DistributeCollectionName

-DistributeContent

-DistributionPointGroupName

-DistributionPointName

-EnableMomAlert

-ForceWildcardHandling

-GenerateScomAlertOnFailure

-Id

-InputObject

-Name

-OverrideServiceWindow

-PersistOnWriteFilterDevice

-RebootOutsideServiceWindow

-SendWakeupPacket

-TimeBaseOn

-UseMeteredNetwork

-UserNotification

-WhatIf

입력

출력

참고

관련 링크

피드백

추가 리소스