다음을 통해 공유

New-CMTSStepRequestStateStore

  • 참조
모듈:
ConfigurationManager

작업 순서에 추가할 수 있는 상태 저장소 요청 단계를 만듭니다.

구문

New-CMTSStepRequestStateStore
   [-FallbackToAccount <Boolean>]
   [-RequestOption <RequestType>]
   [-RetryCount <Int32>]
   [-RetryTime <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet은 새 요청 상태 저장소 단계 개체를 만듭니다. 그런 다음 Add-CMTaskSequenceStep cmdlet을 사용하여 단계를 작업 순서에 추가합니다. 이 단계에 대한 자세한 내용은 작업 순서 단계 정보: 상태 저장소 요청을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예 1

다음은 사용자 상태를 캡처하는 상태 저장소 요청 단계에 대한 개체를 만들고 일반적인 설정을 지정하는 예제입니다.

그런 다음 작업 순서 개체를 가져오고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.

$step = New-CMTSStepRequestStateStore -Name "Request State Store" -RequestOption Capture -FallbackToAccount $false -RetryCount 3 -RetryTime 60

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

매개 변수

-Condition

이 단계에서 사용할 조건 개체를 지정합니다. 이 개체를 얻으려면 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.

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

-Confirm

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

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

-ContinueOnError

이 매개 변수를 추가하여 오류 발생시 단계 옵션 계속을 사용하도록 설정합니다. 이 옵션을 사용하도록 설정하면 단계가 실패하면 작업 순서가 계속됩니다.

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

-Description

이 작업 순서 단계에 대한 선택적 설명을 지정합니다.

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

-Disable

이 매개 변수를 추가하여 이 작업 순서 단계를 사용하지 않도록 설정합니다.

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

-DisableWildcardHandling

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

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

-FallbackToAccount

이 값을 로 $true설정하면 작업 순서가 컴퓨터 계정을 사용하여 상태 마이그레이션 지점에 액세스할 수 없는 경우 네트워크 액세스 계정 자격 증명을 사용하여 연결합니다. 다른 컴퓨터에서 네트워크 액세스 계정을 사용하여 저장된 상태에 액세스할 수 있으므로 이 옵션은 안전하지 않습니다. 대상 컴퓨터가 도메인에 가입되지 않은 경우 이 옵션이 필요할 수 있습니다.

자세한 내용은 네트워크 액세스 계정을 참조하세요.

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

-ForceWildcardHandling

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

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

-Name

이 단계의 이름을 지정하여 작업 순서에서 식별합니다.

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

-RequestOption

상태 마이그레이션 지점에 대한 액세스를 요청하는 이유를 지정합니다.

  • Capture: 컴퓨터에서 상태를 캡처합니다. Configuration Manager 사이트에 여러 활성 상태 마이그레이션 지점이 있는 경우 이 단계에서는 사용 가능한 디스크 공간이 있는 상태 마이그레이션 지점을 찾습니다. 작업 순서는 관리 지점에서 상태 마이그레이션 지점 목록을 쿼리한 다음, 최소 요구 사항을 충족하는 항목을 찾을 때까지 각각을 평가합니다.

  • Restore: 다른 컴퓨터에서 상태를 복원합니다. 여러 상태 마이그레이션 지점이 있는 경우 이 단계에서는 대상 컴퓨터의 상태가 있는 상태 마이그레이션 지점을 찾습니다.

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

-RetryCount

이 단계에서 실패하기 전에 적절한 상태 마이그레이션 지점을 찾으려고 시도하는 횟수를 지정합니다.

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

-RetryTime

작업 순서 단계에서 다시 시도 사이에 대기하는 시간(초)을 지정합니다.

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

-WhatIf

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

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

입력

None

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_RequestStateStoreAction 서버 WMI 클래스를 참조하세요.