Partilhar 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 do reinicia um nó do Service Fabric reiniciando o processo de Fabric.exe que hospeda o nó. Este cmdlet simula falhas de nó do Service Fabric no cluster, que testa os caminhos de recuperação de failover do seu 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, o ID da instância do nó.
  • Especifique uma réplica de serviço com monitoração de estado ou uma instância de serviço sem estado e permita que o cmdlet identifique e reinicie o nó que o hospeda. Vale a pena observar os seguintes comportamentos implícitos para a seleção de réplicas/instâncias:
    • Se o serviço não usar uma partição Singleton e nem o PartitionId nem parâmetro PartitionKey forem especificados, o cmdlet selecionará uma partição aleatoriamente.
    • Se o serviço for um serviço com monitoração de estado e nenhum dos parâmetros Primary, RandomSecondary e ReplicaOrInstanceId forem especificados, o cmdlet selecionará 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 selecionará aleatoriamente uma instância.

Se você especificar um valor diferente de zero para o parâmetro NodeInstanceId, esse ID será comparado com o ID do nó ativo. Se os 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

Este 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 a reinicialização do nó de destino antes de ser concluído.

Exemplo 2: Reiniciar um nó especificado

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

Este comando reinicia o nó chamado Node01. Como o parâmetro CommandCompletionMode é especificado com um valor DoNotVerify, o comando não espera 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 Verify fazer com que o cmdlet aguarde a conclusão da reinicialização e DoNotVerify fazer com que o cmdlet retorne sem aguardar a conclusão da reinicialização.

Tipo:CompletionMode
Valores aceites:Invalid, DoNotVerify, Verify
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CreateFabricDump

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

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

-NodeInstanceId

Especifica um ID de instância de nó. A menos que você especifique 0, o ID da instância do nó especificado 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 Node objeto que contém a ID da instância do nó.

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

-NodeName

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

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

-PartitionId

Especifica a ID da 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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PartitionKey

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

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

-PartitionKindSingleton

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

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

-ReplicaKindPrimary

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

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

-ReplicaKindRandomSecondary

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

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

-ReplicaOrInstanceId

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

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

-TimeoutSec

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

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