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
, , Weeks
Months
. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다.
형식: | 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
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다. 이 값을 지정하는 경우 DeadlineUnit 및 DeadlineValue 를 사용하여 기간을 구성합니다.
형식: | 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