New-CMSoftwareUpdateAutoPhasedDeployment

참조

모듈:: ConfigurationManager

이 cmdlet을 사용하여 동일한 설정으로 두 단계를 생성하여 소프트웨어 업데이트에 대한 단계별 배포를 만듭니다.

구문

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroup] <IResultObject>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupId] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateGroupName] <String>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateIds] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdateNames] <String[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSoftwareUpdateAutoPhasedDeployment
   [-SoftwareUpdates] <IResultObject[]>
   [-AddPhases <Phase[]>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InsertAtOrder <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 동일한 설정으로 두 단계를 생성하여 소프트웨어 업데이트에 대한 단계별 배포를 만듭니다. 이 cmdlet의 동작은 소프트웨어 업데이트에서 단계별 배포 만들기 마법사와 동일하며, 기본 2단계 배포를 자동으로 만드는 옵션을 선택하면 됩니다.

참고

단계적 배포를 만들기 전에 소프트웨어 업데이트 콘텐츠를 배포 지점에 배포해야 합니다.

예제

예제 1: 업데이트 이름으로 배포 만들기

이 예제에서는 소프트웨어 업데이트 myUpdateName에 대해 myDPName이라는 새 소프트웨어 업데이트 단계별 배포를 만듭니다.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

예제 2: 입력 업데이트 개체로 배포 만들기

이 예제에서는 파이프된 소프트웨어 업데이트 개체에 대해 myPDName 이라는 새 소프트웨어 업데이트 단계별 배포를 만듭니다.

$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

매개 변수

-AddPhases

이 cmdlet은 지정된 두 컬렉션에 대해 두 개의 단계를 자동으로 만듭니다. 이 매개 변수를 사용하여 더 많은 단계를 추가할 수도 있습니다. 단계 배열을 지정합니다. New-CMSoftwareUpdatePhase를 사용하여 단계를 만듭니다.

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

-BeginCondition

첫 번째 단계가 성공한 후 배포의 두 번째 단계를 시작하는 옵션을 지정합니다.

AfterPeriod: 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 지연 기간(일) 후에 이 단계를 자동으로 시작합니다. 이 값을 지정하는 경우 DaysAfterPreviousPhaseSuccess 를 사용하여 기간을 구성합니다.
Manually: 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 수동으로 두 번째 단계 배포를 시작합니다.

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

-Confirm

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

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

-CriteriaOption

첫 번째 단계의 성공 조건을 선택하는 옵션을 지정합니다.

Compliance: 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 배포 성공률입니다. CriteriaValue 매개 변수를 사용하여 백분율 값을 지정합니다.
Number: 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 성공적으로 배포된 디바이스 수입니다. CriteriaValue 매개 변수를 사용하여 디바이스 수를 지정합니다.

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

-CriteriaValue

이 정수 값은 CriteriaOption에 대해 지정한 값에 따라 달라집니다.

Compliance: 백분율 지정
Number: 디바이스 수 지정

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

-DaysAfterPreviousPhaseSuccess

첫 번째 단계가 성공한 후의 일 수에 대한 정수 값을 지정하여 두 번째 단계를 시작합니다. 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 지연 기간(일) 후에 이 단계를 자동으로 시작합니다.

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

-DeadlineUnit

최종 기한의 유형을 지정합니다. DeadlineValue에서 이 매개 변수를 사용합니다.

형식:	TimeUnitType
허용되는 값:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeadlineValue

이 매개 변수는 InstallationChoice 매개 변수를 사용하여 지정 AfterPeriod 하는 경우에만 사용됩니다.

마감일 기간의 정수 값을 지정합니다. DeadlineUnit 매개 변수를 사용하여 마침표 Hours형식을 지정합니다. , Days, , WeeksMonths. 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다.

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

-Description

소프트웨어 업데이트 단계별 배포에 대한 설명을 지정합니다.

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

-DisableWildcardHandling

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

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

-FirstCollection

첫 번째 단계에 대한 컬렉션 개체를 지정합니다.

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

-FirstCollectionId

첫 번째 단계에 대한 컬렉션 ID를 지정합니다.

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

-FirstCollectionName

첫 번째 단계의 컬렉션 이름을 지정합니다.

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

-ForceWildcardHandling

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

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

-InsertAtOrder

AddPhases 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 단계 순서대로 추가 단계를 삽입할 위치를 결정합니다. 주문 번호가 있는 정수를 지정합니다.

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

-InstallationChoice

소프트웨어를 사용할 수 있게 된 시기를 기준으로 동작에 대한 옵션을 지정합니다.

AsSoonAsPossible: 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 가능한 한 빨리 설치가 필요합니다.
AfterPeriod: 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다. 이 값을 지정하는 경우 DeadlineUnit 및 DeadlineValue 를 사용하여 기간을 구성합니다.

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

-Name

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

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

-SecondCollection

두 번째 단계에 대한 컬렉션 개체를 지정합니다.

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

-SecondCollectionId

두 번째 단계에 대한 컬렉션 ID를 지정합니다.

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

-SecondCollectionName

두 번째 단계의 컬렉션 이름을 지정합니다.

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

-SoftwareUpdateGroup

소프트웨어 업데이트 그룹에 대한 개체를 지정합니다.

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

-SoftwareUpdateGroupId

ID별로 소프트웨어 업데이트 그룹을 지정합니다.

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

-SoftwareUpdateGroupName

이름으로 소프트웨어 업데이트 그룹을 지정합니다.

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

-SoftwareUpdateIds

소프트웨어 업데이트 ID 배열을 지정합니다.

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

-SoftwareUpdateNames

소프트웨어 업데이트 이름의 배열을 지정합니다.

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

-SoftwareUpdates

소프트웨어 업데이트 개체의 배열을 지정합니다.

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

-ThrottlingDays

이 소프트웨어를 점진적으로 사용할 수 있도록 하려면 일 수의 정수 값을 지정합니다. 이 매개 변수는 콘솔에서 단계별 배포 만들기 마법사의 설정 페이지에서 다음 설정과 동일합니다. 이 기간(일)에 이 소프트웨어를 점진적으로 사용할 수 있도록 합니다.

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

출력

IResultObject

다음을 통해 공유