New-CMTSStepRequestStateStore

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie den Anforderungsstatus Store Schritt, den Sie einer Tasksequenz hinzufügen können.

Syntax

New-CMTSStepRequestStateStore
   [-FallbackToAccount <Boolean>]
   [-RequestOption <RequestType>]
   [-RetryCount <Int32>]
   [-RetryTime <Int32>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Mit diesem Cmdlet wird ein neues Anforderungsstatus-Store Step-Objekt 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 den Schritten der Tasksequenz: Anforderungsstatus Store.

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 ein Objekt für den Anforderungsstatus Store Schritts erstellt, um den Benutzerstatus zu erfassen, und typische Einstellungen werden angegeben.

Anschließend ruft sie ein Tasksequenzobjekt ab und fügt diesen neuen Schritt der Tasksequenz bei Index 11 hinzu.

$step = New-CMTSStepRequestStateStore -Name "Request State Store" -RequestOption Capture -FallbackToAccount $false -RetryCount 3 -RetryTime 60

$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

-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

-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

-FallbackToAccount

Wenn Sie diesen Wert auf $true festlegen, wenn die Tasksequenz nicht mithilfe des Computerkontos auf den Statusmigrationspunkt zugreifen kann, verwendet sie die Anmeldeinformationen des Netzwerkzugriffskontos, um eine Verbindung herzustellen. Diese Option ist weniger sicher, da andere Computer das Netzwerkzugriffskonto verwenden könnten, um auf den gespeicherten Zustand zuzugreifen. Diese Option ist möglicherweise erforderlich, wenn der Zielcomputer keiner Domäne beigetreten ist.

Weitere Informationen finden Sie unter Netzwerkzugriffskonto.

Type:Boolean
Aliases:FallbackToNaa
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

-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

-RequestOption

Geben Sie den Grund für die Anforderung des Zugriffs auf den Statusmigrationspunkt an:

  • Capture: Erfassen des Zustands vom Computer. Wenn der Configuration Manager-Standort mehrere Migrationspunkte für den aktiven Status aufweist, wird in diesem Schritt ein Statusmigrationspunkt mit verfügbarem Speicherplatz gesucht. Die Tasksequenz fragt den Verwaltungspunkt nach einer Liste der Statusmigrationspunkte ab und wertet diese dann aus, bis eine gefunden wird, die die Mindestanforderungen erfüllt.

  • Restore: Wiederherstellen des Zustands von einem anderen Computer. Wenn mehrere Statusmigrationspunkte vorhanden sind, wird in diesem Schritt der Statusmigrationspunkt gesucht, der den Status für den Zielcomputer aufweist.

Type:RequestType
Accepted values:Capture, Restore
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RetryCount

Geben Sie an, wie oft dieser Schritt versucht, einen geeigneten Statusmigrationspunkt zu finden, bevor ein Fehler auftritt.

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

-RetryTime

Geben Sie die Zeitspanne in Sekunden an, die der Tasksequenzschritt zwischen Wiederholungsversuchen wartet.

Type:Int32
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_RequestStateStoreAction Server-WMI-Klasse.