New-CMTSStepRestoreUserState

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie einen Schritt Benutzerstatus wiederherstellen , den Sie einer Tasksequenz hinzufügen können.

Syntax

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

Beschreibung

Dieses Cmdlet erstellt ein neues Schrittobjekt zum Wiederherstellen des Benutzerzustands . Verwenden Sie dann das Cmdlet Add-CMTaskSequenceStep , um den Schritt einer Tasksequenz hinzuzufügen. Weitere Informationen zu diesem Schritt finden Sie unter Informationen zu Tasksequenzschritten: Wiederherstellen des Benutzerstatus.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1

In diesem Beispiel wird zunächst ein Paketobjekt für das User State Migration Tool (USMT) abgerufen. In der nächsten Zeile wird ein -Objekt für den Schritt Benutzerstatus wiederherstellen erstellt, der dieses USMT-Paket verwendet und mehrere Schritteinstellungen konfiguriert. Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz am Index 11 hinzu.

$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

Parameter

-Condition

Geben Sie ein Bedingungsobjekt an, das mit diesem Schritt verwendet werden soll. Verwenden Sie zum Abrufen dieses Objekts eines der Tasksequenzbedingungs-Cmdlets. Beispiel: Get-CMTSStepConditionVariable.

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

-ConfigFile

Wenn Sie angeben -ModeOption Customize , wie Benutzerprofile wiederhergestellt werden sollen, verwenden Sie diesen Parameter, um die Dateinamen benutzerdefinierter XML-Konfigurationsdateien anzugeben. Diese Dateien müssen sich im USMT-Paket befinden.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-ContinueOnError

Fügen Sie diesen Parameter hinzu, um die Schrittoption Bei Fehler fortfahren zu aktivieren. Wenn Sie diese Option aktivieren und der Schritt fehlschlägt, wird die Tasksequenz fortgesetzt.

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

-ContinueOnRestore

Legen Sie diesen Parameter auf fest $true , um die Wiederherstellung des Benutzerzustands und der Einstellungen fortzusetzen, auch wenn USMT einige Dateien nicht wiederherstellen kann.

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

-Description

Geben Sie eine optionale Beschreibung für diesen Tasksequenzschritt an.

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

-Disable

Fügen Sie diesen Parameter hinzu, um diesen Tasksequenzschritt zu deaktivieren.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-ModeOption

Es gibt zwei Modi, in denen USMT betrieben werden kann:

  • Standard: Stellen Sie alle erfassten Benutzerprofile mit Standardoptionen wieder her. Dies ist die Standardeinstellung.

  • Customize: Passen Sie an, wie Benutzerprofile wiederhergestellt werden. Wenn Sie diese Option angeben, verwenden Sie den ConfigFile-Parameter , um die benutzerdefinierten XML-Konfigurationsdateien anzugeben.

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

-Name

Geben Sie einen Namen für diesen Schritt an, um ihn in der Tasksequenz zu identifizieren.

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

-Package

Geben Sie ein Objekt für das USMT-Paket an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMPackage .

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

-Password

Wenn Sie den Parameter RestoreLocalAccount aktivieren, verwenden Sie diesen Parameter, um den wiederhergestellten lokalen Benutzerkonten ein neues Kennwort zuzuweisen. USMT kann die ursprünglichen Kennwörter nicht migrieren. Geben Sie eine sichere Zeichenfolge für das Kennwort des lokalen Kontos an.

Type:SecureString
Aliases:NewPasswordForLocalAccount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestoreLocalAccount

Legen Sie diesen Parameter auf fest $true , um lokale Computerbenutzerprofile wiederherzustellen. Diese Profile sind nicht für Domänenbenutzer vorgesehen. USMT kann die ursprünglichen Kennwörter nicht migrieren. Verwenden Sie den Parameter Password , um den wiederhergestellten lokalen Benutzerkonten neue Kennwörter zuzuweisen.

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

-VerboseLogging

Legen Sie diesen Parameter auf fest $true , um die ausführliche USMT-Protokollierung zu aktivieren.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_RestoreUserStateAction WMI-Serverklasse.