Condividi tramite


Restart-ServiceFabricNode

Riavvia un nodo di Service Fabric per simulare un errore del nodo del cluster.

Sintassi

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>]

Descrizione

Il cmdlet Restart-ServiceFabricNode riavvia un nodo di Service Fabric riavviando il processo di Fabric.exe che ospita il nodo. Questo cmdlet simula gli errori dei nodi di Service Fabric nel cluster, che testa i percorsi di ripristino di failover del servizio. Per altre informazioni, vedere Uso delle azioni di test.

Il nodo di Service Fabric da riavviare può essere specificato nei modi seguenti:

  • Specificare il nome del nodo e facoltativamente l'ID istanza del nodo.
  • Specificare una replica del servizio con stato o un'istanza del servizio senza stato e consentire al cmdlet di identificare e riavviare il nodo che lo ospita. I comportamenti impliciti di folowing per la selezione di repliche/istanze vale la pena notare:
    • Se il servizio non usa una partizione Singleton e non viene specificato né il parametro PartitionIdPartitionKey , il cmdlet seleziona una partizione in modo casuale.
    • Se il servizio è un servizio con stato e nessuno dei parametri Primary, RandomSecondary e ReplicaOrInstanceId vengono specificati, il cmdlet seleziona in modo casuale una replica, indipendentemente dal ruolo.
    • Se il servizio è un servizio senza stato e il parametro ReplicaOrInstanceId non viene specificato, il cmdlet seleziona in modo casuale un'istanza.

Se si specifica un valore diverso da zero per il parametro NodeInstanceId , tale ID viene confrontato con l'ID nodo attivo. Se gli ID non corrispondono, il processo non viene riavviato e si verifica un errore. Un messaggio non aggiornato può causare questo errore.

Se si specifica il parametro CreateFabricDump , questo cmdlet causa l'arresto anomalo del processo di Fabric.exe nel nodo specificato durante il riavvio. Questo arresto anomalo crea un dump di processo per Fabric.exe.

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .

Esempio

Esempio 1: Riavviare un nodo che ospita una replica primaria

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

Questo comando riavvia il nodo che ospita la replica primaria della partizione denominata Partition3. Poiché il parametro CommandCompletionMode viene specificato con un valore Di verifica, il comando attende il riavvio del nodo di destinazione prima del completamento.

Esempio 2: Riavviare un nodo specificato

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

Questo comando riavvia il nodo denominato Node01. Poiché il parametro CommandCompletionMode viene specificato con un valore di DoNotVerify, il comando non attende il riavvio del nodo prima del completamento.

Parametri

-CommandCompletionMode

Specifica se l'azione attende il completamento del riavvio. Specificare Verifica per rendere il cmdlet in attesa del completamento del riavvio e DoNotVerify per rendere il cmdlet restituito senza attendere il completamento del riavvio.

Type:CompletionMode
Accepted values:Invalid, DoNotVerify, Verify
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateFabricDump

Indica che è necessario creare un dump di processo per Fabric.exe nel nodo specificato.

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

-NodeInstanceId

Specifica un ID istanza del nodo. A meno che non si specifica 0, l'ID dell'istanza del nodo specificato deve corrispondere al nodo attualmente in esecuzione. Per ottenere id istanza di nodo, eseguire Get-ServiceFabricNode per il nodo di destinazione. Ad esempio, per il nodo N0050, il comando Get-ServiceFabricNode -NodeName "N0050" restituisce un oggetto Node contenente l'ID istanza del nodo.

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

-NodeName

Specifica il nome di un nodo di Service Fabric. Il cmdlet riavvia il nodo specificato.

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

-PartitionId

Specifica l'ID partizione di una partizione del servizio Service Fabric. Il cmdlet riavvia un nodo che ospita una replica o un'istanza di questa partizione.

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

-PartitionKey

Specifica una chiave di partizione per una partizione del servizio Service Fabric. Il cmdlet identifica la partizione a cui viene eseguito il mapping della chiave di partizione e viene riavviato un nodo che ospita una replica o un'istanza di tale partizione.

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

-PartitionKindNamed

Indica che il parametro PartitionKey specifica una chiave di partizione per un servizio che usa lo schema di partizionamento Denominato.

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

-PartitionKindSingleton

Indica che il servizio specificato nel parametro ServiceName usa una partizione Singleton.

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

-PartitionKindUniformInt64

Indica che il parametro PartitionKey specifica una chiave di partizione per un servizio che usa lo schema di partizionamento UniformInt64.

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

-ReplicaKindPrimary

Indica che questo cmdlet riavvia il nodo che ospita la replica primaria della partizione specificata.

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

-ReplicaKindRandomSecondary

Indica che questo cmdlet riavvia il nodo che ospita una replica secondaria casuale della partizione specificata.

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

-ReplicaOrInstanceId

Specifica una replica del servizio di Service Fabric o un ID istanza. Il cmdlet riavvia il nodo che ospita la replica o l'istanza specificata.

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

-ServiceName

Specifica il nome di un servizio Service Fabric. Il cmdlet riavvia un nodo che ospita una replica o un'istanza di questo servizio.

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

-TimeoutSec

Specifica il periodo di timeout, in secondi, per l'operazione.

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

Input

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]]

Output

System.Object