New-CMTSStepCaptureUserState
작업 순서에 추가할 수 있는 사용자 상태 캡처 단계를 만들 수 있습니다.
Syntax
New-CMTSStepCaptureUserState
[-ConfigFile <String[]>]
[-ContinueOnLockedFile <Boolean>]
[-FileAccessOption <FileAccessType>]
[-ModeOption <ModeType>]
[-OfflineUserState <Boolean>]
-Package <IResultObject>
[-SkipEncryptedFile <Boolean>]
[-UseHardLinks <Boolean>]
[-VerboseLogging <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet은 새 Capture User State 단계 개체를 만듭니다. 그런 다음 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-CMTSStepCaptureUserState -Name "Capture User State" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -FileAccessOption Normal -ContinueOnLockedFile $true -UseHardLinks $true
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11매개 변수
-Condition
이 단계에서 사용할 조건 개체를 지정합니다. 이 개체를 얻습니다. 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConfigFile
사용자 프로필 캡처 방법을 사용자 지정하도록 지정하는 경우 이 매개 변수를 사용하여 사용자 지정 XML 구성 파일의 파일 이름을 -ModeOption Customize 지정합니다. 이러한 파일은 USMT 패키지에 포함해야 합니다.
| Type: | String[] |
| Aliases: | ConfigFiles |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinueOnError
이 매개 변수를 추가하여 오류 시 단계 계속 옵션을 사용하도록 설정할 수 있습니다. 이 옵션을 사용하도록 설정하면 단계가 실패하면 작업 순서가 계속됩니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinueOnLockedFile
를 지정할 때 일부 파일을 캡처할 수 없는 경우 USMT가 계속될 수 있도록 이 매개 -FileAccessOption Normal $true 변수를 설정하십시오.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
이 작업 순서 단계에 대한 선택적 설명을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disable
이 작업 순서 단계를 사용하지 않도록 설정하기 위해 이 매개 변수를 추가합니다.
| Type: | SwitchParameter |
| Aliases: | DisableThisStep |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과결합할 수 있습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileAccessOption
USMT가 파일 시스템에 액세스하는 방법에 대한 두 가지 옵션이 있습니다.
Normal: USMT는 표준 파일 시스템 액세스를 사용 합니다. 이 옵션을 지정할 때 ContinueOnLockedFile, OfflineUserState및 를 사용하도록 설정할 수 - 있습니다.VolumeCopyShadowService: USMT는 VSS(볼륨 복사본 섀도 서비스)를 사용 합니다.
| Type: | FileAccessType |
| Accepted values: | Normal, VolumeCopyShadowService |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하며 예기치 않은 동작이 발생할 수 있습니다(권장하지 않음). DisableWildcardHandling과결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModeOption
USMT가 작동할 수 있는 모드에는 다음 두 가지가 있습니다.
Standard: 표준 옵션을 사용하여 모든 사용자 프로필을 캡처합니다. 이 옵션은 기본 옵션입니다.Customize: 사용자 프로필 캡처 방법을 사용자 지정합니다. 이 옵션을 지정하는 경우 ConfigFile 매개 변수를 사용하여 사용자 지정 XML 구성 파일을 지정합니다.
| Type: | ModeType |
| Accepted values: | Standard, Customize |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
이 단계의 이름을 지정하여 작업 순서에서 식별합니다.
| Type: | String |
| Aliases: | StepName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OfflineUserState
를 지정하면 PE에서 오프라인 모드로 캡처할 수 Windows -FileAccessOption Normal $true 설정됩니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Package
USMT 패키지에 대한 개체를 지정합니다. 이 개체를 얻습니다. Get-CMPackage cmdlet을 사용합니다.
| Type: | IResultObject |
| Aliases: | UserStateMigrationToolPackage |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipEncryptedFile
EFS(암호화 파일 시스템)를 사용하는 파일을 건너뛰기 위해 이 매개 $true 변수를 설정하십시오.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseHardLinks
를 지정할 때 이 매개 변수를 설정하여 NTFS 하드 링크를 사용하여 로컬로 -FileAccessOption Normal $true 캡처합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VerboseLogging
USMT의 verbose 로깅을 사용하도록 설정하려면 이 $true 매개 변수를 설정해야 합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. 이 cmdlet은 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
없음
출력
IResultObject
참고
이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_TaskSequence_CaptureUserStateAction 서버 WMI 클래스를 참조하세요.