다음을 통해 공유


New-CMTaskSequencePhase

이 cmdlet을 사용하여 작업 순서에 대한 배포 단계를 만듭니다.

구문

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 작업 순서에 대한 배포 단계를 만듭니다.

예제

예제 1: 작업 순서 단계 만들기

이 예제에서는 MyCollection이라는 컬렉션에 대해 MyTSPhase라는 작업 순서 단계를 만듭니다.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

매개 변수

-AllowFallback

이 매개 변수는 콘솔에서 단계 추가 마법사배포 지점 페이지에서 클라이언트가 기본 사이트 경계 그룹의 배포 지점을 사용할 수 있도록 허용하는 설정과 동일합니다.

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

-AllowRemoteDP

이 매개 변수는 콘솔에서 단계 추가 마법사배포 지점 페이지에서 다음 설정과 동일합니다. 로컬 배포 지점을 사용할 수 없는 경우 원격 배포 지점을 사용합니다.

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

-AllowSystemRestart

이 매개 변수는 콘솔에서 단계 추가 마법사사용자 환경 페이지에서 시스템 다시 시작(설치를 완료하는 데 필요한 경우)의 설정과 동일합니다. 이 설정은 설치 기한에 도달하면 적용되므로 유지 관리 기간 외부에서 이 작업을 수행할 수 있습니다.

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

-BeginCondition

이전 단계의 성공 후 이 배포 단계를 시작하기 위한 옵션을 지정합니다.

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

  • Manually: 이 매개 변수는 콘솔에서 단계 추가 마법사단계 설정 페이지에서 다음 설정과 동일합니다. 수동으로 이 배포 단계를 시작합니다.

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

-Collection

대상 컬렉션에 대한 개체 지정

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

-CollectionId

ID별로 대상 컬렉션을 지정합니다.

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

-CollectionName

이름으로 대상 컬렉션을 지정합니다.

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

-Comments

이 단계에 대한 선택적 주석을 지정합니다. 최대 길이는 512자입니다.

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

-DeploymentOption

이 매개 변수는 콘솔에서 단계 추가 마법사배포 지점 페이지에서 다음 설정과 동일합니다. 클라이언트가 인접 경계 그룹 또는 기본 사이트 경계 그룹의 배포 지점을 사용할 때 사용할 배포 옵션을 선택합니다. 다음 값을 허용합니다.

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: 실행 중인 작업 순서에서 필요한 경우 로컬로 콘텐츠 다운로드
  • DownloadAllContentLocallyBeforeStartingTaskSequence: 작업 순서를 시작하기 전에 모든 콘텐츠를 로컬로 다운로드
형식:DeploymentOptionType
허용되는 값:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InstallationChoice

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

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

  • AfterPeriod: 이 매개 변수는 콘솔에서 단계 추가 마법사단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다. 이 값을 지정하는 경우 DeadlineUnitDeadlineValue 를 사용하여 기간을 구성합니다.

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

-PhaseName

단계의 이름을 지정합니다.

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

-PreDownload

이 매개 변수는 콘솔에서 단계 추가 마법사일반 페이지에서 다음 설정과 동일합니다. 이 작업 순서에 대한 콘텐츠를 미리 다운로드합니다.

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

-SoftwareInstallation

이 매개 변수는 콘솔에서 단계 추가 마법사사용자 환경 페이지에서 소프트웨어 설치 설정과 동일합니다. 이 설정은 설치 기한에 도달하면 적용되므로 유지 관리 기간 외부에서 이 작업을 수행할 수 있습니다.

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

-ThrottlingDays

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

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

-UserNotification

이 매개 변수는 콘솔의 단계 추가 마법사사용자 환경 페이지에서 다음 설정과 동일합니다. 다음 값을 사용하여 이 배포에 대한 사용자 환경 설정을 지정합니다.

  • DisplayAll: 소프트웨어 센터에 표시 및 모든 알림 표시
  • HideAll: 소프트웨어 센터 및 모든 알림에서 숨기기
형식:UserNotificationType
허용되는 값:DisplayAll, HideAll
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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

-WriteFilterCommit

이 매개 변수는 콘솔에서 단계 추가 마법사사용자 환경 페이지에서 최종 기한 또는 유지 관리 기간 동안 변경 내용 커밋(다시 시작 필요)의 설정과 동일합니다. 이 설정은 Windows Embedded 디바이스에 대한 쓰기 필터 처리에 적용됩니다.

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

입력

None

출력

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase