Freigeben über

Start-ServiceFabricNodeTransition

  • Referenz
Modul:
ServiceFabric

Initiiert einen Vorgang zum Starten oder Beenden eines Service Fabric-Clusterknotens.

Syntax

Start-ServiceFabricNodeTransition
     [-Stop]
     -OperationId <Guid>
     -NodeName <String>
     -NodeInstanceId <BigInteger>
     -StopDurationInSeconds <Int32>
     [-TimeoutSec <Int32>]
     [<CommonParameters>]
Start-ServiceFabricNodeTransition
     [-Start]
     -OperationId <Guid>
     -NodeName <String>
     -NodeInstanceId <BigInteger>
     [-TimeoutSec <Int32>]
     [<CommonParameters>]

Beschreibung

Das Start-ServiceFabricNodeTransition Cmdlet initiiert einen asynchronen Vorgang zum Starten oder Beenden eines Service Fabric-Clusterknotens.

Wenn Sie den parameter Stop angeben, wird ein Service Fabric-Clusterknoten in einen angehaltenen Zustand versetzt. Ein Knoten ist ein Prozess, kein virtueller Computer oder Computer. Der virtuelle Computer oder Computer wird weiterhin ausgeführt, nachdem der Knoten beendet wurde. Im angehaltenen Zustand ist der Knoten kein Mitglied des Clusters und kann keine Dienste hosten. Ein angehaltener Knoten simuliert einen Knoten, der nach unten oder offline ist.

Durch Angeben des Start--Parameters wird ein Knoten gestartet, der beendet wurde.

Wenn dieses Cmdlet erfolgreich zurückgegeben wird, hat das System den Vorgang akzeptiert. Dies bedeutet jedoch nicht, dass der Vorgang abgeschlossen ist. Um Informationen zum aktuellen Status des Vorgangs abzurufen, führen Sie das cmdlet Get-ServiceFabricNodeTransitionProgress aus.

Das Start-ServiceFabricNodeTransition Cmdlet wird gegenüber den Start-ServiceFabricNode und Stop-ServiceFabricNode Cmdlets bevorzugt, die veraltet sind. Vermeiden Sie das Mischen der Verwendung dieses Cmdlets mit Start-ServiceFabricNode- und Stop-ServiceFabricNode-. Wenn ein Knoten bereits mit Stop-ServiceFabricNode-beendet wurde, starten Sie ihn mit Start-ServiceFabricNode-, bevor Sie Start-ServiceFabricNodeTransitionverwenden. Verwenden Sie Start-ServiceFabricNodeTransition- anschließend.

Weitere Informationen finden Sie unter Ersetzen der Startknoten- und Stoppknoten-APIs durch die Node Transition API.

Beispiele

Beispiel 1: Beenden eines Service Fabric-Knotens

PS C:\> Start-ServiceFabricNodeTransition -Stop -OperationId 097b03e3-760a-419c-9fce-e83f8cc0894b -NodeName N0050 -NodeInstanceId 131242467532403195 -StopDurationInSeconds 3600

Dieser Befehl initiiert einen Vorgang, um einen Service Fabric-Knoten für eine Stunde zu beenden. Nach einer Stunde beginnt der Knoten automatisch selbst. Verfolgen Sie den wert OperationId. Sie können es verwenden, um Get-ServiceFabricNodeTransitionProgressauszuführen.

Beispiel 2: Starten eines Service Fabric-Knotens

PS C:\> Start-ServiceFabricNodeTransition -Start -OperationId 6d1bf9a1-9733-4d83-be59-0acea3be57a7 -NodeName N0050 -NodeInstanceId 131242467532403195

Dieser Befehl initiiert einen Vorgang, um einen angehaltenen Service Fabric-Knoten zu starten.

Parameter

-NodeInstanceId

Gibt die ID der Knoteninstanz an, die dieses Cmdlet startet oder beendet. Um Knoteninstanz-IDs abzurufen, führen Sie Get-ServiceFabricNode- für den Zielknoten aus. For example, for the node N0050, the command Get-ServiceFabricNode -NodeName "N0050" returns a Node object that contains the node instance ID.

Typ:BigInteger
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeName

Gibt den Namen des Service Fabric-Knotens an, den dieses Cmdlet startet oder beendet. Um Service Fabric-Knoten in Ihrem Cluster abzurufen, führen Sie das cmdlet Get-ServiceFabricNode aus.

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

-OperationId

Gibt eine eindeutige ID an, die den Vorgang identifiziert. Verwenden Sie denselben Wert für dieses Cmdlet, das den Vorgang initiiert, und Get-ServiceFabricNodeTransitionProgress, wodurch der Vorgangsfortschritt abgerufen wird.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Start

Gibt an, dass dieses Cmdlet einen angehaltenen Knoten startet.

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

-Stop

Gibt an, dass dieses Cmdlet einen ausgeführten Knoten stoppt.

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

-StopDurationInSeconds

Gibt die Dauer in Sekunden an, um einen angehaltenen Knoten nach Abschluss des Vorgangs anzuhalten. Nach diesem Zeitpunkt wird der Knoten automatisch gestartet.

Der Mindestwert ist 600. Der Maximalwert ist 14400.

Sie müssen den parameter Stop angeben, um eine Stoppdauer anzugeben.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutwert in Sekunden für dieses Cmdlet an.

Dies ist nicht die Zeitspanne, die der angehaltene Knoten angehalten hat. Um zu steuern, wie lange ein Knoten beendet wird, verwenden Sie den StopDurationInSeconds Parameter.

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

Eingaben

None

Ausgaben

System.Object