Restart-ServiceFabricReplica

Módulo:

ServiceFabric

Reinicia uma réplica do Service Fabric para simular a reabertura de uma réplica de serviço com estado.

Sintaxe

Restart-ServiceFabricReplica
       [-NodeName] <String>
       [-PartitionId] <Guid>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Description

O cmdlet Restart-ServiceFabricReplica simula uma falha de réplica de serviço reiniciando uma réplica de serviço persistente, fechando a réplica e reabrindo-a. Use este cmdlet para testar seu serviço em busca de problemas ao longo do caminho de reabertura da réplica. Esse cmdlet ajuda a simular o caminho temporário de falha do relatório por meio de APIs do cliente. Esse cmdlet só é válido para réplicas que pertencem a serviços persistentes com estado.

Para especificar a réplica a ser reiniciada, podemos começar com o nome do nó ou o nome do serviço.

Em seguida, precisamos especificar a partição à qual a réplica pertence. Podemos especificar a partição especificando o par (esquema de nomenclatura, chave de partição) ou especificando a ID da partição. Para obter mais detalhes sobre o particionamento de serviço do Microsoft Azure Service Fabric, consulte serviços confiáveis do Service Fabric de partição.

Por fim, talvez seja necessário especificar a réplica da partição à qual estamos nos referindo e isso pode ser feito especificando a função de réplica (réplica primária ou secundária) ou especificando a ID da réplica.

Em alguns casos, talvez o usuário queira reiniciar uma combinação aleatória de partição/réplica para um serviço em vez de uma específica. Isso é útil para testar a capacidade de seus serviços quando você deseja executar um conjunto aleatório de transições para seus serviços para simular falhas do mundo real. Por exemplo, se você fornecer apenas o nome do serviço para esse cmdlet e deixar de fora a partição e/ou as informações de réplica, o cmdlet fará uma escolha aleatória para selecionar uma partição e uma réplica para falha. Observe que a partição ou réplica selecionada pertencerá apenas ao serviço especificado.

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 uma réplica

PS C:\> Restart-ServiceFabricReplica -NodeName "Node07" -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaOrInstanceId 12345098480948

Esse comando reinicia a réplica no Node07 na partição especificada.

Exemplo 2: reiniciar uma réplica primária

PS C:\> Restart-ServiceFabricReplica -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition1" -ServiceName fabric:/App/Service

Esse comando reinicia uma réplica primária na partição especificada.

Parâmetros

-CommandCompletionMode

Especifica se a ação aguarda a conclusão da operação de 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

-NodeName

Especifica o nome de um nó do Service Fabric. O cmdlet reinicia uma réplica implantada no 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 da partição para a qual reiniciar a réplica.

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

-PartitionKey

Especifica a chave da partição para a qual a réplica é reiniciada.

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

-PartitionKindNamed

Indica que esse cmdlet reinicia uma réplica em uma partição nomeada.

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

-PartitionKindSingleton

Indica que esse cmdlet reinicia uma réplica em uma partição singleton.

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

-PartitionKindUniformInt64

Indica que esse cmdlet reinicia uma réplica em uma partição UniformInt64.

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

-ReplicaKindPrimary

Indica que esse cmdlet reinicia a réplica da réplica primária.

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

-ReplicaKindRandomSecondary

Indica que esse cmdlet reinicia uma réplica para uma réplica secundária aleatória.

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

-ReplicaOrInstanceId

Especifica uma réplica de serviço do Service Fabric ou uma ID da instância.

Tipo:	Int64
Cargo:	2
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.

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.Guid

System.Uri

System.Management.Automation.SwitchParameter

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

Saídas

System.Object

Links Relacionados

• Connect-ServiceFabricCluster
• Get-ServiceFabricReplica
• Remove-ServiceFabricReplica