Compartilhar via

Restart-ServiceFabricNode

  • Referência
Módulo:
ServiceFabric

Reinicia um nó do Service Fabric para simular uma falha de nó de cluster.

Sintaxe

Restart-ServiceFabricNode
       [-NodeName] <String>
       [[-NodeInstanceId] <BigInteger>]
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricNode
       [-CommandCompletionMode <CompletionMode>]
       [-CreateFabricDump]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Description

O cmdlet Restart-ServiceFabricNode reinicia um nó do Service Fabric reiniciando o processo de Fabric.exe que hospeda o nó. Esse cmdlet simula falhas de nó do Service Fabric no cluster, que testa os caminhos de recuperação de failover do serviço. Para obter mais informações, consulte Usando ações de teste.

O nó do Service Fabric a ser reiniciado pode ser especificado das seguintes maneiras:

  • Especifique o nome do nó e, opcionalmente, a ID da instância do nó.
  • Especifique uma réplica de serviço com estado ou uma instância de serviço sem estado e deixe que o cmdlet identifique e reinicie o nó que o hospeda. Vale a pena observar os comportamentos implícitos de folowing para a seleção de réplica/instância:
    • Se o serviço não usar uma partição Singleton e nem o parâmetro PartitionId nem PartitionKey for especificado, o cmdlet escolherá uma partição aleatoriamente.
    • Se o serviço for um serviço com estado e nenhum dos parâmetros Primário, RandomSecondary e ReplicaOrInstanceId forem especificados, o cmdlet escolherá aleatoriamente uma réplica, independentemente de sua função.
    • Se o serviço for um serviço sem estado e o parâmetro ReplicaOrInstanceId não for especificado, o cmdlet escolherá aleatoriamente uma instância.

Se você especificar um valor diferente de zero para o parâmetro NodeInstanceId , essa ID será comparada com a ID do nó ativo. Se as IDs não corresponderem, o processo não será reiniciado e ocorrerá um erro. Uma mensagem obsoleta pode causar esse erro.

Se você especificar o parâmetro CreateFabricDump , esse cmdlet fará com que o processo de Fabric.exe falhe no nó especificado durante a reinicialização. Essa falha cria um despejo de processo para Fabric.exe.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Reiniciar um nó que hospeda uma réplica primária

PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify

Esse comando reinicia o nó que hospeda a réplica primária da partição chamada Partition3. Como o parâmetro CommandCompletionMode é especificado com um valor de Verify, o comando aguarda que o nó de destino seja reiniciado antes de ser concluído.

Exemplo 2: Reiniciar um nó especificado

PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify

Esse comando reinicia o nó chamado Node01. Como o parâmetro CommandCompletionMode é especificado com um valor de DoNotVerify, o comando não aguarda que o nó seja reiniciado antes de ser concluído.

Parâmetros

-CommandCompletionMode

Especifica se a ação aguarda a conclusão da reinicialização. Especifique Verificar para fazer com que o cmdlet aguarde a conclusão da reinicialização e o DoNotVerify para fazer o cmdlet retornar sem aguardar a conclusão da reinicialização.

Tipo:CompletionMode
Valores aceitos:Invalid, DoNotVerify, Verify
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CreateFabricDump

Indica que um despejo de processo deve ser criado para Fabric.exe no nó especificado.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NodeInstanceId

Especifica uma ID de instância de nó. A menos que você especifique 0, a ID da instância do nó especificada deve corresponder ao nó em execução no momento. 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ó.

Tipo:BigInteger
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NodeName

Especifica o nome de um nó do Service Fabric. O cmdlet reinicia o nó especificado.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PartitionId

Especifica a ID de partição de uma partição de serviço do Service Fabric. O cmdlet reinicia um nó que hospeda uma réplica ou instância dessa partição.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PartitionKey

Especifica uma chave de partição para uma partição de serviço do Service Fabric. O cmdlet identifica a partição que essa chave de partição mapeia e reinicia um nó que hospeda uma réplica ou instância dessa partição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PartitionKindNamed

Indica que o parâmetro PartitionKey especifica uma chave de partição para um serviço que usa o esquema de particionamento Nomeado.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionKindSingleton

Indica que o serviço especificado no parâmetro ServiceName usa uma partição Singleton.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionKindUniformInt64

Indica que o parâmetro PartitionKey especifica uma chave de partição para um serviço que usa o esquema de particionamento UniformInt64.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicaKindPrimary

Indica que esse cmdlet reinicia o nó que hospeda a réplica primária da partição especificada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicaKindRandomSecondary

Indica que esse cmdlet reinicia o nó que hospeda uma réplica secundária aleatória da partição especificada.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplicaOrInstanceId

Especifica uma réplica de serviço ou uma ID de instância do Service Fabric. O cmdlet reinicia o nó que hospeda a réplica ou instância especificada.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServiceName

Especifica o nome de um serviço do Service Fabric. O cmdlet reinicia um nó que hospeda uma réplica ou instância desse serviço.

Tipo:Uri
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.String

System.Nullable`1[[System.Numerics.BigInteger, System.Numerics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Guid

System.Uri

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Saídas

System.Object