New-CMTaskSequencePhase
이 cmdlet을 사용하여 작업 순서에 대한 배포 단계를 만듭니다.
Syntax
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
이 매개 변수는 콘솔에서 단계 추가 마법사의 배포 지점 페이지에서 클라이언트가 기본 사이트 경계 그룹의 배포 지점을 사용할 수 있도록 허용하는 설정과 동일합니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowRemoteDP
이 매개 변수는 콘솔에서 단계 추가 마법사의 배포 지점 페이지에서 다음 설정과 동일합니다. 로컬 배포 지점을 사용할 수 없는 경우 원격 배포 지점을 사용합니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSystemRestart
이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 시스템 다시 시작(설치를 완료하는 데 필요한 경우)의 설정과 동일합니다. 이 설정은 설치 기한에 도달할 때 적용되므로 유지 관리 기간 외부에서 이 작업을 수행할 수 있습니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
이전 단계의 성공 후 이 배포 단계를 시작하기 위한 옵션을 지정합니다.
AfterPeriod
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 지연 기간(일) 후에 이 단계를 자동으로 시작합니다. 이 값을 지정하는 경우 DaysAfterPreviousPhaseSuccess 를 사용하여 기간을 구성합니다.Manually
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 수동으로 이 배포 단계를 시작합니다.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
대상 컬렉션에 대한 개체 지정
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
ID별로 대상 컬렉션을 지정합니다.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
이름으로 대상 컬렉션을 지정합니다.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comments
이 단계에 대한 선택적 주석을 지정합니다. 최대 길이는 512자입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaOption
이전 단계의 성공 조건을 선택하는 옵션을 지정합니다.
Compliance
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 배포 성공률 설정과 동일합니다. CriteriaValue 매개 변수를 사용하여 백분율 값을 지정합니다.Number
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 성공적으로 배포된 디바이스 수입니다. CriteriaValue 매개 변수를 사용하여 디바이스 수를 지정합니다.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
이 정수 값은 CriteriaOption에 대해 지정한 값에 따라 달라집니다.
Compliance
: 백분율 지정Number
: 디바이스 수 지정
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
이 단계를 시작하기 위해 이전 단계의 성공 후 일 수에 대한 정수 값을 지정합니다. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 지연 기간(일) 후에 이 단계를 자동으로 시작합니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
최종 기한의 유형을 지정합니다. DeadlineValue에서 이 매개 변수를 사용합니다.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
이 매개 변수는 InstallationChoice 매개 변수를 사용하여 지정 AfterPeriod
하는 경우에만 사용됩니다.
마감일 기간의 정수 값을 지정합니다. DeadlineUnit 매개 변수를 사용하여 마침표 Hours
형식을 지정합니다. , Days
, , Weeks
Months
. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentOption
이 매개 변수는 콘솔에서 단계 추가 마법사의 배포 지점 페이지에서 다음 설정과 동일합니다. 클라이언트가 인접 경계 그룹 또는 기본 사이트 경계 그룹의 배포 지점을 사용할 때 사용할 배포 옵션을 선택합니다. 다음 값을 허용합니다.
DownloadContentLocallyWhenNeededByRunningTaskSequence
: 실행 중인 작업 순서에서 필요한 경우 로컬로 콘텐츠 다운로드DownloadAllContentLocallyBeforeStartingTaskSequence
: 작업 순서를 시작하기 전에 모든 콘텐츠를 로컬로 다운로드
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작으로 이어질 수 있습니다. 권장되지 않습니다. DisableWildcardHandling과 결합할 수 없습니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
소프트웨어를 사용할 수 있게 된 시기를 기준으로 동작에 대한 옵션을 지정합니다.
AsSoonAsPossible
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 가능한 한 빨리 설치가 필요합니다.AfterPeriod
: 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간 후에 설치가 필요합니다. 이 값을 지정하는 경우 DeadlineUnit 및 DeadlineValue 를 사용하여 기간을 구성합니다.
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhaseName
단계의 이름을 지정합니다.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDownload
이 매개 변수는 콘솔에서 단계 추가 마법사의 일반 페이지에서 다음 설정과 동일합니다. 이 작업 순서에 대한 콘텐츠를 미리 다운로드합니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 소프트웨어 설치 설정과 동일합니다. 이 설정은 설치 기한에 도달할 때 적용되므로 유지 관리 기간 외부에서 이 작업을 수행할 수 있습니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
이 소프트웨어를 점진적으로 사용할 수 있도록 하려면 일 수의 정수 값을 지정합니다. 이 매개 변수는 콘솔에서 단계 추가 마법사의 단계 설정 페이지에서 다음 설정과 동일합니다. 이 기간(일)에 이 소프트웨어를 점진적으로 사용할 수 있도록 합니다.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
이 매개 변수는 콘솔의 단계 추가 마법사의 사용자 환경 페이지에서 다음 설정과 동일합니다. 다음 값을 사용하여 이 배포에 대한 사용자 환경 설정을 지정합니다.
DisplayAll
: 소프트웨어 센터에 표시 및 모든 알림 표시HideAll
: 소프트웨어 센터 및 모든 알림에서 숨기기
Type: | UserNotificationType |
Accepted values: | DisplayAll, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WriteFilterCommit
이 매개 변수는 콘솔에서 단계 추가 마법사의 사용자 환경 페이지에서 최종 기한 또는 유지 관리 기간 동안 변경 내용 커밋(다시 시작 필요)의 설정과 동일합니다. 이 설정은 Windows Embedded 디바이스에 대한 쓰기 필터 처리에 적용됩니다.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
None
출력
Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기