Compartir a través de


Restart-ServiceFabricNode

Reinicia un nodo de Service Fabric para simular un error de nodo de clúster.

Syntax

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

El cmdlet Restart-ServiceFabricNode reinicia un nodo de Service Fabric reiniciando el proceso de Fabric.exe que hospeda el nodo. Este cmdlet simula errores de nodo de Service Fabric en el clúster, que prueba las rutas de recuperación de conmutación por error del servicio. Para obtener más información, consulte Uso de acciones de prueba.

El nodo de Service Fabric que se va a reiniciar puede especificar de las siguientes maneras:

  • Especifique el nombre del nodo y, opcionalmente, el identificador de instancia del nodo.
  • Especifique una réplica de servicio con estado o una instancia de servicio sin estado y permita que el cmdlet identifique y reinicie el nodo que lo hospeda. Cabe destacar los comportamientos implícitos para la selección de réplica o instancia:
    • Si el servicio no usa una partición singleton y no se especifica el parámetro PartitionId ni PartitionKey , el cmdlet elige una partición aleatoriamente.
    • Si el servicio es un servicio con estado y ninguno de los parámetros Primary, RandomSecondary y ReplicaOrInstanceId se especifican, el cmdlet elige aleatoriamente una réplica, independientemente de su rol.
    • Si el servicio es un servicio sin estado y no se especifica el parámetro ReplicaOrInstanceId , el cmdlet elige aleatoriamente una instancia.

Si especifica un valor distinto de cero para el parámetro NodeInstanceId , ese identificador se compara con el identificador de nodo activo. Si los identificadores no coinciden, el proceso no se reinicia y se produce un error. Un mensaje obsoleto puede provocar este error.

Si especifica el parámetro CreateFabricDump , este cmdlet hace que el proceso de Fabric.exe se bloquee en el nodo especificado durante el reinicio. Este bloqueo crea un volcado de memoria de proceso para Fabric.exe.

Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .

Ejemplos

Ejemplo 1: Reinicio de un nodo que hospeda una réplica principal

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

Este comando reinicia el nodo que hospeda la réplica principal de la partición denominada Partition3. Dado que el parámetro CommandCompletionMode se especifica con un valor de Verify, el comando espera a que se reinicie el nodo de destino antes de que se complete.

Ejemplo 2: Reiniciar un nodo especificado

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

Este comando reinicia el nodo denominado Node01. Dado que el parámetro CommandCompletionMode se especifica con un valor de DoNotVerify, el comando no espera a que se reinicie el nodo antes de que se complete.

Parámetros

-CommandCompletionMode

Especifica si la acción espera a que se complete el reinicio. Especifique Verify para que el cmdlet espere a que se complete el reinicio y DoNotVerify para que el cmdlet devuelva sin esperar a que se complete el reinicio.

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

-CreateFabricDump

Indica que se debe crear un volcado de memoria de proceso para Fabric.exe en el nodo especificado.

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

-NodeInstanceId

Especifica un identificador de instancia de nodo. A menos que especifique 0, el identificador de instancia de nodo que especifique debe coincidir con el nodo que se está ejecutando actualmente. Para obtener identificadores de instancia de nodo, ejecute Get-ServiceFabricNode para el nodo de destino. Por ejemplo, para el nodo N0050, el comando Get-ServiceFabricNode -NodeName "N0050" devuelve un objeto Node que contiene el identificador de instancia del nodo.

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

-NodeName

Especifica el nombre de un nodo de Service Fabric. El cmdlet reinicia el nodo que especifique.

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

-PartitionId

Especifica el identificador de partición de una partición de servicio de Service Fabric. El cmdlet reinicia un nodo que hospeda una réplica o instancia de esta partición.

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

-PartitionKey

Especifica una clave de partición para una partición de servicio de Service Fabric. El cmdlet identifica la partición a la que esta clave de partición se asigna y reinicia un nodo que hospeda una réplica o instancia de esa partición.

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

-PartitionKindNamed

Indica que el parámetro PartitionKey especifica una clave de partición para un servicio que usa el esquema de partición con nombre.

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

-PartitionKindSingleton

Indica que el servicio especificado en el parámetro ServiceName usa una partición Singleton.

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

-PartitionKindUniformInt64

Indica que el parámetro PartitionKey especifica una clave de partición para un servicio que usa el esquema de partición UniformInt64.

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

-ReplicaKindPrimary

Indica que este cmdlet reinicia el nodo que hospeda la réplica principal de la partición especificada.

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

-ReplicaKindRandomSecondary

Indica que este cmdlet reinicia el nodo que hospeda una réplica secundaria aleatoria de la partición especificada.

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

-ReplicaOrInstanceId

Especifica una réplica de servicio de Service Fabric o un identificador de instancia. El cmdlet reinicia el nodo que hospeda la réplica o instancia especificadas.

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

-ServiceName

Especifica el nombre de un servicio de Service Fabric. El cmdlet reinicia un nodo que hospeda una réplica o instancia de este servicio.

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

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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]]

Salidas

System.Object