Partilhar via

Start-ServiceFabricNodeTransition

  • Referência
Módulo:
ServiceFabric

Inicia uma operação para iniciar ou parar um nó de cluster do Service Fabric.

Sintaxe

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.

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

Especificar o parâmetro Start 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 terminado. Para obter informações sobre o estado atual da operação, execute o cmdlet Get-ServiceFabricNodeTransitionProgress.

O cmdlet Start-ServiceFabricNodeTransition é preferido sobre os Start-ServiceFabricNode e cmdlets 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 substituindo as APIs do nó inicial e do nó de parada com a 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

Este comando inicia uma operação para parar um nó do Service Fabric por uma hora. Após uma hora, o nó é iniciado automaticamente. Acompanhe o valor do 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

Este 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 esse 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 Node objeto que contém a ID da instância do nó.

Tipo:BigInteger
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NodeName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OperationId

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

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Start

Indica que esse cmdlet inicia um nó interrompido.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Stop

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:Int32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

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

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object