Compartilhar via

Start-ServiceFabricNodeTransition

  • Referência
Módulo:
ServiceFabric

Inicia uma operação para iniciar ou parar um nó de cluster do 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

O cmdlet Start-ServiceFabricNodeTransition inicia uma operação assíncrona para iniciar ou parar um nó de cluster do Service Fabric.

Especificar o parâmetro Stop coloca um nó de cluster do Service Fabric em um estado parado. Um nó é um processo, não uma máquina virtual ou um computador. A máquina virtual ou o computador continua a ser executado depois que o nó é interrompido. No estado parado, o nó não é membro do cluster e não pode hospedar serviços. Um nó parado simula um nó que está offline ou baixo.

Especificar o parâmetro Iniciar inicia um nó que foi interrompido.

Quando esse cmdlet retorna com êxito, o sistema aceita a operação. No entanto, isso não implica que a operação tenha sido concluída. Para obter informações sobre o estado atual da operação, execute o cmdlet Get-ServiceFabricNodeTransitionProgress .

O cmdlet Start-ServiceFabricNodeTransition é preferencial em relação aos cmdlets Start-ServiceFabricNode e Stop-ServiceFabricNode , que são obsoletos. Evite misturar o uso desse cmdlet com Start-ServiceFabricNode e Stop-ServiceFabricNode. Se um nó já tiver sido interrompido usando Stop-ServiceFabricNode, inicie-o usando Start-ServiceFabricNode antes de usar Start-ServiceFabricNodeTransition. Use Start-ServiceFabricNodeTransition a partir de então.

Para obter mais informações, consulte Substituir as APIs de nó Iniciar e Parar nó pela API de Transição de Nó.

Exemplos

Exemplo 1: Parar um nó do Service Fabric

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

Esse comando inicia uma operação para interromper um nó do Service Fabric por uma hora. Após uma hora, o nó é iniciado automaticamente. Acompanhe o valor de OperationId . Você pode usá-lo para executar Get-ServiceFabricNodeTransitionProgress.

Exemplo 2: Iniciar um nó do Service Fabric

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

Esse comando inicia uma operação para iniciar um nó do Service Fabric interrompido.

Parâmetros

-NodeInstanceId

Especifica a ID da instância do nó que este cmdlet inicia ou para. Para obter IDs de instância de nó, execute Get-ServiceFabricNode para o nó de destino. Por exemplo, para o nó N0050, o comando Get-ServiceFabricNode -NodeName "N0050" retorna um objeto Node que contém a ID da instância do nó.

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

-NodeName

Especifica o nome do nó do Service Fabric que este cmdlet inicia ou para. Para obter nós do Service Fabric em seu cluster, execute o cmdlet Get-ServiceFabricNode .

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

-OperationId

Especifica uma ID exclusiva que identifica a operação. Use o mesmo valor para este cmdlet, que inicia a operação, e Get-ServiceFabricNodeTransitionProgress, que obtém o progresso da operação.

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

-Start

Indica que esse cmdlet inicia um nó parado.

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

-Stop

Indica que esse cmdlet interrompe um nó em execução.

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

-StopDurationInSeconds

Especifica a duração, em segundos, para manter um nó parado interrompido após a conclusão da operação para parar. Após esse tempo, o nó é iniciado automaticamente.

O valor mínimo é 600. O valor máximo é 14400.

Você deve especificar o parâmetro Stop para especificar uma duração de parada.

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

-TimeoutSec

Especifica o valor de tempo limite, em segundos, para este cmdlet.

Esse não é o período de tempo que o nó parado permanece parado. Para controlar por quanto tempo um nó é interrompido, use o parâmetro StopDurationInSeconds .

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

Entradas

None

Saídas

System.Object