Freigeben über

New-CMTSStepCaptureUserState

  • Referenz
Modul:
ConfigurationManager

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

Syntax

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

Beschreibung

Dieses Cmdlet erstellt ein neues Schrittobjekt erfassen 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: Erfassen des Benutzerstatus.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 erfassen 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-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

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.

Typ:IResultObject[]
Aliase:Conditions
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConfigFile

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

Typ:String[]
Aliase:ConfigFiles
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ContinueOnError

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ContinueOnLockedFile

Wenn Sie angeben -FileAccessOption Normal, legen Sie diesen Parameter auf fest $true , damit USMT fortgesetzt werden kann, wenn einige Dateien nicht erfasst werden können.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Disable

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

Typ:SwitchParameter
Aliase:DisableThisStep
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FileAccessOption

Es gibt zwei Optionen für den Zugriff von USMT auf das Dateisystem:

  • Normal: USMT verwendet standardmäßigen Dateisystemzugriff. Wenn Sie diese Option angeben, können Sie auch ContinueOnLockedFile, OfflineUserState und -aktivieren.

  • VolumeCopyShadowService: USMT verwendet die Volumeschattendienste (Volume Copy Shadow Services, VSS).

Typ:FileAccessType
Zulässige Werte:Normal, VolumeCopyShadowService
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ModeOption

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

  • Standard: Erfassen Sie alle Benutzerprofile mithilfe von Standardoptionen. Dies ist die Standardeinstellung.

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

Typ:ModeType
Zulässige Werte:Standard, Customize
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Aliase:StepName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OfflineUserState

Wenn Sie angeben -FileAccessOption Normal, legen Sie diesen Parameter auf fest $true , um in Windows PE im Offlinemodus zu erfassen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Package

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

Typ:IResultObject
Aliase:UserStateMigrationToolPackage
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipEncryptedFile

Legen Sie diesen Parameter auf fest $true , um Dateien zu überspringen, die das verschlüsselnde Dateisystem (Encrypting File System, EFS) verwenden.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseHardLinks

Wenn Sie angeben -FileAccessOption Normal, legen Sie diesen Parameter auf fest $true , um die lokale Erfassung mithilfe harter NTFS-Links zu erstellen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VerboseLogging

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

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

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