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 11Parametri
-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 |
-UseHardLinks
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.