Freigeben über

Get-CMTSStepCaptureUserState

  • Referenz
Modul:
ConfigurationManager

Rufen Sie den Schritt Benutzerstatus erfassen aus einer bestimmten Tasksequenz ab.

Syntax

Get-CMTSStepCaptureUserState
   [-InputObject] <IResultObject>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CMTSStepCaptureUserState
   [-TaskSequenceId] <String>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-CMTSStepCaptureUserState
   [-TaskSequenceName] <String>
   [-StepName <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Tasksequenzschrittobjekt für eine oder mehrere Instanzen des Schritts Benutzerstatus erfassen abzurufen. Sie können dieses Objekt für Folgendes verwenden:

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 Tasksequenzobjekt in der variablen $tsOsd abgerufen. Anschließend wird diese Variable als Eingabeobjekt übergeben, um den Schritt Benutzerstatus erfassen abzurufen.

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsStepNameCapState = "Capture User State"
$tsStepCapState = Get-CMTSStepCaptureUserState -InputObject $tsOsd -StepName $tsStepNameCapState

Parameter

-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

-InputObject

Geben Sie ein Tasksequenzobjekt an, aus dem der Schritt Benutzerstatus erfassen abgerufen werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMTaskSequence .

Typ:IResultObject
Aliase:TaskSequence
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StepName

Geben Sie den Namen des Schritts Benutzerstatus erfassen an, der von der Tasksequenz abgerufen werden soll.

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

-TaskSequenceId

Geben Sie die Paket-ID der Tasksequenz an, aus der der Schritt Benutzerstatus erfassen abgerufen werden soll. Dieser Wert ist eine Standardpaket-ID, z. B XYZ00858. .

Typ:String
Aliase:Id, TaskSequencePackageId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TaskSequenceName

Geben Sie den Namen der Tasksequenz an, aus der der Schritt Benutzerstatus erfassen abgerufen werden soll.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object