다음을 통해 공유


New-CMTSStepRestoreUserState

작업 순서에 추가할 수 있는 사용자 상태 복원 단계를 만듭니다.

구문

New-CMTSStepRestoreUserState
   [-ConfigFile <String[]>]
   [-ContinueOnRestore <Boolean>]
   [-ModeOption <ModeType>]
   -Package <IResultObject>
   [-Password <SecureString>]
   [-RestoreLocalAccount <Boolean>]
   [-VerboseLogging <Boolean>]
   [-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

이 예제에서는 먼저 USMT(사용자 상태 마이그레이션 도구)에 대한 패키지 개체를 가져옵니다. 다음 줄은 해당 USMT 패키지를 사용하고 여러 단계 설정을 구성하는 사용자 상태 복원 단계에 대한 개체를 만듭니다. 그런 다음 작업 순서 개체를 가져오고 인덱스 11의 작업 순서에 이 새 단계를 추가합니다.

$pkgUsmt = Get-CMPackage -Name "User State Migration Tool for Windows" -Fast

$step = New-CMTSStepRestoreUserState -Name "Restore User State" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -ContinueOnRestore $true -RestoreLocalAccount $false

$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

-ConfigFile

사용자 프로필을 복원하는 방법을 사용자 지정하도록 지정 -ModeOption Customize 하는 경우 이 매개 변수를 사용하여 사용자 지정 XML 구성 파일의 파일 이름을 지정합니다. 이러한 파일은 USMT 패키지에 있어야 합니다.

형식:String[]
별칭:ConfigFiles
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

-ContinueOnRestore

USMT에서 일부 파일을 복원할 수 없는 경우에도 사용자 상태 및 설정을 계속 복원하려면 이 매개 변수 $true 를 로 설정합니다.

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

-ForceWildcardHandling

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

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

-ModeOption

USMT가 작동할 수 있는 두 가지 모드가 있습니다.

  • Standard: 표준 옵션을 사용하여 캡처된 모든 사용자 프로필을 복원합니다. 이 옵션은 기본 옵션입니다.

  • Customize: 사용자 프로필을 복원하는 방법을 사용자 지정합니다. 이 옵션을 지정하는 경우 ConfigFile 매개 변수를 사용하여 사용자 지정 XML 구성 파일을 지정합니다.

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

-Name

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

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

-Package

USMT 패키지에 대한 개체를 지정합니다. 이 개체를 얻으려면 Get-CMPackage cmdlet을 사용합니다.

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

-Password

RestoreLocalAccount 매개 변수를 사용하도록 설정하는 경우 이 매개 변수를 사용하여 복원된 로컬 사용자 계정에 새 암호를 할당합니다. USMT는 원래 암호를 마이그레이션할 수 없습니다. 로컬 계정 암호에 대한 보안 문자열을 지정합니다.

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

-RestoreLocalAccount

로컬 컴퓨터 사용자 프로필을 복원하려면 이 매개 변수 $true 를 로 설정합니다. 이러한 프로필은 도메인 사용자를 위한 것이 아닙니다. USMT는 원래 암호를 마이그레이션할 수 없습니다. 복원된 로컬 사용자 계정에 새 암호를 할당하려면 Password 매개 변수를 사용합니다.

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

-VerboseLogging

USMT 자세한 로깅을 사용하도록 설정하려면 이 매개 변수 $true 를 로 설정합니다.

형식:Boolean
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_RestoreUserStateAction 서버 WMI 클래스를 참조하세요.