Condividi tramite

New-CMTSStepRestoreUserState

  • Riferimento
Modulo:
ConfigurationManager

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

Sintassi

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

Descrizione

Questo cmdlet crea un nuovo oggetto passaggio Ripristina 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à: Ripristinare 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 Ripristina 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-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

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

-ContinueOnRestore

Impostare questo parametro su $true per continuare a ripristinare lo stato utente e le impostazioni anche se USMT non è in grado di ripristinare alcuni file.

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

-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: ripristinare tutti i profili utente acquisiti con le opzioni standard. Questa è l'opzione predefinita.

  • Customize: personalizzare la modalità di ripristino 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

-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

-Password

Se si abilita il parametro RestoreLocalAccount , usare questo parametro per assegnare una nuova password agli account utente locali ripristinati. USMT non può eseguire la migrazione delle password originali. Specificare una stringa sicura per la password dell'account locale.

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

-RestoreLocalAccount

Impostare questo parametro su $true per ripristinare i profili utente del computer locale. Questi profili non sono destinati agli utenti di dominio. USMT non può eseguire la migrazione delle password originali. Per assegnare nuove password agli account utente locali ripristinati, usare il parametro Password .

Tipo:Boolean
Alias:RestoreLocalComputerUserProfile
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_RestoreUserStateAction classe WMI del server.