New-CMTSStepCaptureUserState
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.