New-CMSoftwareUpdateAutoPhasedDeployment

모듈:

ConfigurationManager

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

Syntax

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를 사용하여 단계를 만들 수 있습니다.

Type:	Phase[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BeginCondition

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

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

• Manually: 이 매개 변수는 콘솔에서 단계적 배포 만들기 **** 마법사의 설정 페이지의 다음 설정과 동일합니다. 2단계 배포를 수동으로 시작하십시오.

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
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

-CriteriaOption

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

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

• Number: 이 매개 변수는 콘솔에서 단계적 배포 만들기 **** 마법사의 설정 페이지의 다음 설정과 같습니다. 성공적으로 배포된 장치 수입니다. CriteriaValue 매개 변수를 사용하여 디바이스 수를 지정합니다.

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

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

• Compliance: 백분율 지정

• Number: 장치 수 지정

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

-DaysAfterPreviousPhaseSuccess

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

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

-DeadlineUnit

기한 유형을 지정합니다. DeadlineValue와함께 이 매개 변수를 사용합니다.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

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

기한 기간에 대한 정수 값을 지정합니다. DeadlineUnit 매개 변수를 사용하여 기간 유형을 지정합니다. Hours Days , , Weeks Months . 이 매개 변수는 콘솔에서 단계적 배포 만들기 마법사의 설정 페이지의 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다. ****

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

-Description

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

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

-FirstCollection

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

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

-FirstCollectionId

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

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

-FirstCollectionName

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

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

-InsertAtOrder

AddPhases 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 추가 단계를 삽입할 단계 순서를 결정할 수 있습니다. 정수와 순서를 지정합니다.

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

-InstallationChoice

소프트웨어를 사용할 수 있는 시간을 상대로 동작에 대한 옵션을 지정합니다.

• AsSoonAsPossible: 이 매개 변수는 콘솔에서 단계적 배포 만들기 **** 마법사의 설정 페이지의 다음 설정과 동일합니다. 가능한 한 빨리 설치가 필요합니다.

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

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

응용 프로그램 단계적 배포의 이름을 지정합니다.

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

-SecondCollection

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

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

-SecondCollectionId

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

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

-SecondCollectionName

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

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

-SoftwareUpdateGroup

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

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SoftwareUpdateGroupId

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

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

-SoftwareUpdateGroupName

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

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

-SoftwareUpdateIds

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

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdateNames

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

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareUpdates

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

Type:	IResultObject[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ThrottlingDays

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

출력

IResultObject