Поделиться через


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 не указан, командлет выбирает секцию случайным образом.
    • Если служба является службой с отслеживанием состояния и ни одной из основных, 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

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

Тип:CompletionMode
Допустимые значения:Invalid, DoNotVerify, Verify
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CreateFabricDump

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NodeInstanceId

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

Тип:BigInteger
Position:1
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-NodeName

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

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PartitionId

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

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PartitionKey

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PartitionKindNamed

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PartitionKindSingleton

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PartitionKindUniformInt64

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReplicaKindPrimary

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReplicaKindRandomSecondary

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReplicaOrInstanceId

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

Тип:Int64
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ServiceName

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

Тип:Uri
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TimeoutSec

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

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки: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