Send-ServiceFabricNodeHealthReport
Отправляет отчет о работоспособности на узле Service Fabric.
Синтаксис
Send-ServiceFabricNodeHealthReport
[-NodeName] <String>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Описание
Командлет send-ServiceFabricNodeHealthReport отправляет отчет о работоспособности на узле Service Fabric.
Узел должен уже существовать в хранилище работоспособности.
Чтобы проверить, существует ли она, используйте командлет Get-ServiceFabricNodeHealth .
Кроме того, можно использовать командлет Get-ServiceFabricNode
Командлет отправляет отчет после интервала, указанного параметром HealthReportSendIntervalInSec командлета Connect-ServiceFabricCluster. Подключение к кластеру должно оставаться в живых в течение этого времени. Команда вычисляется на клиенте без ссылки на выполнение в хранилище работоспособности. Отчет может не применяться в хранилище работоспособности, даже если команда возвращает успешное выполнение. Например, хранилище работоспособности может отклонить отчет из-за недопустимого параметра, например устаревший порядковый номер.
Чтобы узнать, был ли отчет применен в хранилище работоспособности, используйте командлет Get-ServiceFabricNodeHealth и убедитесь, что отчет отображается в разделе HealthEvents.
Чтобы управлять кластерами Service Fabric, запустите Windows PowerShell с помощью параметра "Запуск от имени администратора". Перед выполнением любой операции в кластере Service Fabric установите подключение к кластеру с помощью командлета Connect-ServiceFabricCluster, а затем командлет Get-ServiceFabricClusterConnection.
Примеры
Пример 1. Отчет о работоспособности отчета об ошибке с бесконечным сроком жизни
PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "Firewall" -HealthState Error -Description "Firewall rules were not correctly applied"Эта команда отправляет отчет о работоспособности узла с именем Node01 из источника MyWatchdog. Отчет о работоспособности содержит сведения о свойстве работоспособности брандмауэре в состоянии работоспособности ошибки с бесконечным TTL.
Пример 2. Предупреждение отчета, допустимое для указанного срока жизни
PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "CPU" -HealthState Warning -Description "CPU has been more than 90% for the last hour." -TimeToLiveSec 10 -RemoveWhenExpiredЭта команда отправляет отчет о работоспособности узла с именем Node01 из источника MyWatchdog. Отчет о работоспособности содержит сведения о свойстве работоспособности ЦП в состоянии работоспособности предупреждений. Команда также содержит описание предупреждения, задает значение TTL до 10 секунд и настраивает удаление отчета при истечении срока действия.
Параметры
-Description
Указывает удобочитаемую пользователем информацию о условии, которое активировало отчет. SourceId, HealthPropertyи параметры HealthState полностью описывают отчет.
Максимальная длина строки описания — 4096 символов. Если указанная строка длиннее, она автоматически усечена. При усечении описание заканчивается маркером "[Усечено], чтобы указать пользователям, что усечение произошло. Общий размер строки составляет 4096 символов, поэтому хранятся менее 4096 символов из исходной строки.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-HealthProperty
Указывает свойство отчета. Вместе с параметром SourceId SourceId это свойство однозначно идентифицирует отчет. Отчет переопределяет все предыдущие отчеты с теми же значениями для SourceId и параметры HealthProperty в одной сущности.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-HealthState
Указывает объект HealthState, представляющий сообщаемое состояние работоспособности.
| Тип: | HealthState |
| Допустимые значения: | Invalid, Ok, Warning, Error, Unknown |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Immediate
Указывает, следует ли немедленно отправлять отчет в хранилище работоспособности. Это полезно для критических отчетов, которые должны отправляться как можно скорее. Если это не указано, отчет отправляется на основе параметров клиента работоспособности. Таким образом, он будет пакетирован в соответствии с конфигурацией HealthReportSendInterval. Это рекомендуемый параметр, так как он позволяет клиенту работоспособности оптимизировать сообщения отчетов о работоспособности в хранилище работоспособности, а также обработку отчетов о работоспособности. По умолчанию клиент Структуры PowerShell задает значение HealthReportSentInterval равным 0, поэтому отчеты отправляются немедленно.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-NodeName
Указывает имя узла Service Fabric. Командлет отправляет отчет о работоспособности на заданном узле.
| Тип: | String |
| Position: | 0 |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-RemoveWhenExpired
Указывает, что отчет удаляется из хранилища работоспособности при истечении срока его действия. Если этот параметр не указан, сущность считается в состоянии ошибки при истечении срока действия отчета. Отчеты, которые удаляются при истечении срока действия, можно использовать только для условий, допустимых только в течение определенного периода времени или для очистки отчетов из хранилища работоспособности.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SequenceNumber
Указывает порядковый номер, связанный с отчетом о работоспособности. Если значение этого параметра не указано, порядковый номер устанавливается автоматически. Если указать порядковый номер, это значение должно быть выше, чем любой предыдущий номер последовательности, заданный в том же SourceId и HealthProperty, или отчет отклоняется из-за устаревания.
| Тип: | Int64 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-SourceId
Указывает идентификатор источника, активировающего отчет.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-TimeoutSec
Указывает период времени ожидания (в секундах) для операции.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TimeToLiveSec
Указывает время жизни отчета в секундах. По истечении срока действия TTL отчет удаляется из хранилища работоспособности, если указан параметр RemoveWhenExpired. В противном случае сущность оценивается по ошибке из-за истечения срока действия отчета. Значение по умолчанию — Infinite.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
Входные данные
System.String
System.Fabric.Health.HealthState
System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Management.Automation.SwitchParameter
System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Выходные данные
System.Object