Condividi tramite


New-CMTSStepCaptureUserState

Creare un passaggio Acquisisci stato utente , che è possibile aggiungere a una sequenza di attività.

Sintassi

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>]

Descrizione

Questo cmdlet crea un nuovo oggetto passaggio Acquisisci stato utente . Usare quindi il cmdlet Add-CMTaskSequenceStep per aggiungere il passaggio a una sequenza di attività. Per altre informazioni su questo passaggio, vedere Informazioni sui passaggi della sequenza di attività: Acquisire lo stato utente.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio viene innanzitutto ottenuto un oggetto pacchetto per lo Strumento di migrazione dello stato utente (USMT). La riga successiva crea un oggetto per il passaggio Acquisisci stato utente , che usa il pacchetto USMT e configura diverse impostazioni dei passaggi. Ottiene quindi un oggetto sequenza di attività e aggiunge questo nuovo passaggio alla sequenza di attività in corrispondenza dell'indice 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

Parametri

-Condition

Specificare un oggetto condizione da usare con questo passaggio. Per ottenere questo oggetto, usare uno dei cmdlet della condizione della sequenza di attività. Ad esempio, Get-CMTSStepConditionVariable.

Tipo:IResultObject[]
Alias:Conditions
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConfigFile

Quando si specifica -ModeOption Customize di personalizzare la modalità di acquisizione dei profili utente, usare questo parametro per specificare i nomi dei file di configurazione XML personalizzati. Questi file devono trovarsi nel pacchetto USMT.

Tipo:String[]
Alias:ConfigFiles
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContinueOnError

Aggiungere questo parametro per abilitare l'opzione di passaggio Continua in caso di errore. Quando si abilita questa opzione, se il passaggio ha esito negativo, la sequenza di attività continua.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContinueOnLockedFile

Quando si specifica -FileAccessOption Normal, impostare questo parametro su per consentire a $true USMT di continuare se alcuni file non possono essere acquisiti.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa per questo passaggio della sequenza di attività.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Disable

Aggiungere questo parametro per disabilitare questo passaggio della sequenza di attività.

Tipo:SwitchParameter
Alias:DisableThisStep
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FileAccessOption

Sono disponibili due opzioni per l'accesso di USMT al file system:

  • Normal: USMT usa l'accesso al file system standard. Quando si specifica questa opzione, è anche possibile abilitare ContinueOnLockedFile, OfflineUserState e -.

  • VolumeCopyShadowService: USMT usa i servizi Shadow della copia del volume.

Tipo:FileAccessType
Valori accettati:Normal, VolumeCopyShadowService
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ModeOption

Esistono due modalità in cui USMT può operare:

  • Standard: acquisire tutti i profili utente usando le opzioni standard. Questa è l'opzione predefinita.

  • Customize: personalizzare la modalità di acquisizione dei profili utente. Se si specifica questa opzione, usare il parametro ConfigFile per specificare i file di configurazione XML personalizzati.

Tipo:ModeType
Valori accettati:Standard, Customize
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare un nome per questo passaggio per identificarlo nella sequenza di attività.

Tipo:String
Alias:StepName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OfflineUserState

Quando si specifica -FileAccessOption Normal, impostare questo parametro $true su per l'acquisizione in modalità offline in Windows PE.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Package

Specificare un oggetto per il pacchetto USMT. Per ottenere questo oggetto, usare il cmdlet Get-CMPackage .

Tipo:IResultObject
Alias:UserStateMigrationToolPackage
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SkipEncryptedFile

Impostare questo parametro su $true per ignorare i file che usano il file system di crittografia (EFS).

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Quando si specifica -FileAccessOption Normal, impostare questo parametro su $true per l'acquisizione in locale tramite collegamenti rigidi NTFS.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VerboseLogging

Impostare questo parametro su $true per abilitare la registrazione dettagliata USMT.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_CaptureUserStateAction classe WMI del server.