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 Configuration Manager cmdlet dall'unità del sito 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.

Type:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Aliases:ConfigFiles
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Disable

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

Type:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 il modo in cui vengono ripristinati i profili utente. Se si specifica questa opzione, usare il parametro ConfigFile per specificare i file di configurazione XML personalizzati.

Type:ModeType
Accepted values:Standard, Customize
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Aliases:StepName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Package

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

Type:IResultObject
Aliases:UserStateMigrationToolPackage
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SecureString
Aliases:NewPasswordForLocalAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Boolean
Aliases:RestoreLocalComputerUserProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerboseLogging

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.