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