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