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

Mit diesem Cmdlet wird ein neues Schrittobjekt für den Erfassungsbenutzerstatus erstellt. 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 beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel1

In diesem Beispiel wird zuerst ein Paketobjekt für das Migrationstool für den Benutzerstatus (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 bei 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

-Bedingung

Geben Sie ein Bedingungsobjekt an, das für diesen Schritt verwendet werden soll. Um dieses Objekt abzurufen, verwenden Sie eines der Cmdlets für die Tasksequenzbedingung. Beispiel: Get-CMTSStepConditionVariable.

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

-ConfigFile

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

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

-ContinueOnError

Fügen Sie diesen Parameter hinzu, um die Schrittoption "Continue on error" zu aktivieren. Wenn Sie diese Option aktivieren, wird die Tasksequenz fortgesetzt, wenn der Schritt fehlschlägt.

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

-ContinueOnLockedFile

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

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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, OfflineUserStateund - aktivieren.
VolumeCopyShadowService: USMT verwendet die Volumeschattendienste (Volume Copy Shadow Services, VSS).

Type:	FileAccessType
Accepted values:	Normal, VolumeCopyShadowService
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

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

-ModeOption

Es gibt zwei Modi, in denen USMT ausgeführt werden kann:

Standard: Erfassen Sie alle Benutzerprofile mithilfe von Standardoptionen. Dies ist die Standardeinstellung.
Customize: Anpassen der Erfassung von Benutzerprofilen. Wenn Sie diese Option angeben, verwenden Sie den Parameter ConfigFile, um die benutzerdefinierten XML-Konfigurationsdateien anzugeben.

Type:	ModeType
Accepted values:	Standard, Customize
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-OfflineUserState

Wenn Sie dies angeben, legen Sie -FileAccessOption Normal diesen Parameter so fest, dass er im $true Offlinemodus in Windows PE erfasst wird.

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

-SkipEncryptedFile

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

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

-UseHardLinks

Wenn Sie dies angeben, legen Sie diesen Parameter so fest, dass er -FileAccessOption Normal lokal $true mithilfe von NTFS-Hardlinks erfasst wird.

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

-VerboseLogging

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

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

Eingaben

Keine

Ausgaben

IResultObject

Hinweise

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