Compartir a través de

Start-ServiceFabricNodeTransition

  • Referencia
Módulo:
ServiceFabric

Inicia una operación para iniciar o detener un nodo de clúster de Service Fabric.

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>]

Description

El cmdlet Start-ServiceFabricNodeTransition inicia una operación asincrónica para iniciar o detener un nodo de clúster de Service Fabric.

Al especificar el parámetro Stop , se coloca un nodo de clúster de Service Fabric en un estado detenido. Un nodo es un proceso, no una máquina virtual o un equipo. La máquina virtual o el equipo continúa ejecutándose después de detener el nodo. En el estado detenido, el nodo no es miembro del clúster y no puede hospedar servicios. Un nodo detenido simula un nodo inactivo o sin conexión.

Al especificar el parámetro Start , se inicia un nodo detenido.

Cuando este cmdlet vuelve correctamente, el sistema ha aceptado la operación. Sin embargo, esto no implica que la operación haya finalizado. Para obtener información sobre el estado actual de la operación, ejecute el cmdlet Get-ServiceFabricNodeTransitionProgress .

Se prefiere el cmdlet Start-ServiceFabricNodeTransition sobre los cmdlets Start-ServiceFabricNode y Stop-ServiceFabricNode , que están obsoletos. Evite mezclar el uso de este cmdlet con Start-ServiceFabricNode y Stop-ServiceFabricNode. Si ya se ha detenido un nodo mediante Stop-ServiceFabricNode, inícielo con Start-ServiceFabricNode antes de usar Start-ServiceFabricNodeTransition. Use Start-ServiceFabricNodeTransition desde entonces.

Para obtener más información, consulte Reemplazo de las API de nodo de inicio y detención de nodos con node transition API.

Ejemplos

Ejemplo 1: Detener un nodo de Service Fabric

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

Este comando inicia una operación para detener un nodo de Service Fabric durante una hora. Después de una hora, el nodo se inicia automáticamente. Realice un seguimiento del valor OperationId . Puede usarlo para ejecutar Get-ServiceFabricNodeTransitionProgress.

Ejemplo 2: Inicio de un nodo de Service Fabric

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

Este comando inicia una operación para iniciar un nodo detenido de Service Fabric.

Parámetros

-NodeInstanceId

Especifica el identificador de la instancia de nodo que este cmdlet inicia o detiene. Para obtener identificadores de instancia de nodo, ejecute Get-ServiceFabricNode para el nodo de destino. Por ejemplo, para el nodo N0050, el comando Get-ServiceFabricNode -NodeName "N0050" devuelve un objeto Node que contiene el identificador de instancia del nodo.

Type:BigInteger
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NodeName

Especifica el nombre del nodo de Service Fabric que este cmdlet inicia o detiene. Para obtener nodos de Service Fabric en el clúster, ejecute el cmdlet Get-ServiceFabricNode .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OperationId

Especifica un identificador único que identifica la operación. Use el mismo valor para este cmdlet, que inicia la operación y Get-ServiceFabricNodeTransitionProgress, que obtiene el progreso de la operación.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Start

Indica que este cmdlet inicia un nodo detenido.

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

-Stop

Indica que este cmdlet detiene un nodo en ejecución.

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

-StopDurationInSeconds

Especifica la duración, en segundos, para mantener detenido un nodo detenido una vez completada la operación para detenerla. Después de esta hora, el nodo se inicia automáticamente.

El valor mínimo es 600. El valor máximo es 14400.

Debe especificar el parámetro Stop para especificar una duración de detención.

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

-TimeoutSec

Especifica el valor de tiempo de espera, en segundos, para este cmdlet.

Este no es el período de tiempo que permanece detenido el nodo detenido. Para controlar cuánto tiempo se detiene un nodo, use el parámetro StopDurationInSeconds .

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

Entradas

None

Salidas

System.Object