Restart-ServiceFabricNode

Перезапускает узел Service Fabric, чтобы имитировать сбой узла кластера.

Синтаксис

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

Описание

Командлет Restart-ServiceFabricNode перезапускает узел Service Fabric, перезапуская процесс Fabric.exe, на котором размещен узел. Этот командлет имитирует сбои узла Service Fabric в кластере, который проверяет пути восстановления отработки отказа службы. Дополнительные сведения см. в разделе "Использование действий тестирования".

Перезапущенный узел Service Fabric можно указать следующими способами:

  • Укажите имя узла и при необходимости идентификатор экземпляра узла.
  • Укажите реплику службы с отслеживанием состояния или экземпляр службы без отслеживания состояния и разрешите командлету определить и перезапустить узел, на котором он размещен. Неявное поведение для выбора реплики или экземпляра стоит отметить:
    • Если служба не использует одноэлементную секцию и не указан ни параметр PartitionId , ни PartitionKey , командлет случайным образом выбирает секцию.
    • Если служба является службой с отслеживанием состояния и ни одна из параметров Primary, RandomSecondary и ReplicaOrInstanceId не указана, командлет случайным образом выбирает реплику независимо от ее роли.
    • Если служба является службой без отслеживания состояния, а параметр ReplicaOrInstanceId не указан, командлет случайным образом выбирает экземпляр.

Если указать ненулевое значение для параметра NodeInstanceId , этот идентификатор сравнивается с идентификатором активного узла. Если идентификаторы не совпадают, процесс не перезапускается и возникает ошибка. Устаревшее сообщение может вызвать эту ошибку.

Если указать параметр CreateFabricDump , этот командлет приводит к сбою процесса Fabric.exe на указанном узле во время перезапуска. Этот сбой создает дамп процесса для Fabric.exe.

Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster .

Примеры

Пример 1. Перезапуск узла, на котором размещена первичная реплика

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

Эта команда перезапускает узел, на котором размещена первичная реплика секции с именем Partition3. Так как параметр CommandCompletionMode указан со значением Verify, команда ожидает перезапуска целевого узла до его завершения.

Пример 2. Перезапуск указанного узла

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

Эта команда перезапускает узел с именем Node01. Так как параметр CommandCompletionMode задается со значением DoNotVerify, команда не ожидает перезапуска узла до его завершения.

Параметры

-CommandCompletionMode

Указывает, ожидает ли действие завершения перезапуска. Укажите параметр Verify , чтобы дождаться завершения перезапуска командлета, и DoNotVerify , чтобы вернуть командлет, не ожидая завершения перезапуска.

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

-CreateFabricDump

Указывает, что дамп процесса должен быть создан для Fabric.exe на указанном узле.

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

-NodeInstanceId

Указывает идентификатор экземпляра узла. Если не указано значение 0, указанный идентификатор экземпляра узла должен совпадать с текущим запущенным узлом. Чтобы получить идентификаторы экземпляров узла, запустите Get-ServiceFabricNode для целевого узла. Например, для узла N0050 команда Get-ServiceFabricNode -NodeName "N0050" возвращает объект Node , содержащий идентификатор экземпляра узла.

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

-NodeName

Указывает имя узла Service Fabric. Командлет перезапускает указанный узел.

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

-PartitionId

Указывает идентификатор секции секции службы Service Fabric. Командлет перезапускает узел, на котором размещена реплика или экземпляр этой секции.

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

-PartitionKey

Указывает ключ секции для секции службы Service Fabric. Командлет определяет секцию, с которой сопоставляется этот ключ секции, и перезапускает узел, на котором размещена реплика или экземпляр этого раздела.

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

-PartitionKindNamed

Указывает, что параметр PartitionKey указывает ключ секции для службы, использующую схему именованного секционирования.

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

-PartitionKindSingleton

Указывает, что служба, указанная в параметре ServiceName , использует секцию Singleton.

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

-PartitionKindUniformInt64

Указывает, что параметр PartitionKey указывает ключ секции для службы, использующую схему секционирования UniformInt64.

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

-ReplicaKindPrimary

Указывает, что этот командлет перезапускает узел, на котором размещена первичная реплика указанной секции.

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

-ReplicaKindRandomSecondary

Указывает, что этот командлет перезапускает узел, на котором размещена случайная вторичная реплика указанной секции.

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

-ReplicaOrInstanceId

Указывает реплику службы Или идентификатор экземпляра Service Fabric. Командлет перезапускает узел, на котором размещена указанная реплика или экземпляр.

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

-ServiceName

Указывает имя службы Service Fabric. Командлет перезапускает узел, на котором размещена реплика или экземпляр этой службы.

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

-TimeoutSec

Указывает период времени ожидания (в секундах) для операции.

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

Входные данные

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

Выходные данные

System.Object