Get-ServiceFabricServiceHealth
Service Fabric 서비스의 상태를 가져옵니다.
구문
Get-ServiceFabricServiceHealth
[-ServiceName] <Uri>
[-ConsiderWarningAsError <Boolean>]
[-MaxPercentUnhealthyPartitionsPerService <Byte>]
[-MaxPercentUnhealthyReplicasPerPartition <Byte>]
[-EventsHealthStateFilter <Int64>]
[-EventsFilter <HealthStateFilter>]
[-PartitionsHealthStateFilter <Int64>]
[-PartitionsFilter <HealthStateFilter>]
[-ExcludeHealthStatistics]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Get-ServiceFabricServiceHealth cmdlet은 Service Fabric 서비스의 상태를 가져옵니다. 상태 저장소에 없는 서비스를 지정하는 경우 이 cmdlet은 예외를 반환합니다.
Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.
예제
예제 1: 서비스 상태 쿼리
PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1이 명령은 지정된 서비스의 상태를 가져옵니다.
예제 2: 사용자 지정 상태 정책을 사용하여 서비스 상태 가져오기 및 필터 반환
PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ConsiderWarningAsError $True -EventsFilter Error -PartitionsFilter 'Warning,Error'이 명령은 지정된 서비스의 상태를 쿼리합니다. 상태 정책에 대한 값을 제공합니다. 필터를 사용하여 오류 이벤트와 오류 또는 경고 상태의 자식만 반환합니다.
예제 3: 서비스의 상태를 쿼리하고 상태 통계 제외
PS C:\> Get-ServiceFabricServiceHealth -ServiceName fabric:/myapp/persistenttodolist/svc1 -ExcludeHealthStatistics이 명령은 지정된 서비스의 상태를 가져옵니다. 반환된 서비스 상태에는 서비스 상태 통계가 포함되지 않습니다.
매개 변수
-ConsiderWarningAsError
상태 평가 중에 경고 상태 보고서를 오류로 처리할지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EventsFilter
상태 상태에 따라 엔터티에 보고된 HealthEvent 컬렉션에 대한 필터를 지정합니다. 이 값은 HealthStateFilter의 멤버에 대한 멤버 또는 비트 연산에서 가져올 수 있습니다. 필터와 일치하는 이벤트만 반환됩니다. 모든 이벤트는 집계된 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다.
| 형식: | HealthStateFilter |
| 허용되는 값: | Default, None, Ok, Warning, Error, All |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EventsHealthStateFilter
이 매개 변수는 더 이상 사용되지 않습니다. 대신 EventsFilter 매개 변수를 지정합니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExcludeHealthStatistics
상태 통계를 쿼리 결과에 포함할지 여부를 나타냅니다. 지정한 경우 상태 통계는 쿼리 결과의 일부로 반환되지 않습니다. 그렇지 않으면 쿼리 결과에는 Ok, Warning 및 Error 상태에 있는 이 서비스의 파티션 및 복제본 수에 대한 정보가 포함된 서비스 상태 통계가 포함됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxPercentUnhealthyPartitionsPerService
서비스에서 허용되는 비정상 파티션의 최대 백분율을 지정합니다. 허용된 것보다 상태 오류가 있는 파티션이 더 많은 경우 서비스의 상태가 오류입니다.
| 형식: | Byte |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxPercentUnhealthyReplicasPerPartition
비정상 파티션 복제본의 최대 허용 비율을 지정합니다. 상태 오류가 허용되는 것보다 많은 복제본이 있는 경우 파티션의 상태는 오류입니다.
| 형식: | Byte |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PartitionsFilter
상태에 따라 PartitionHealthState 자식에 대한 필터를 지정합니다. 이 값은 HealthStateFilter의 멤버에 대한 멤버 또는 비트 연산에서 가져올 수 있습니다. 필터와 일치하는 자식만 반환됩니다. 모든 자식은 엔터티 집계 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다.
| 형식: | HealthStateFilter |
| 허용되는 값: | Default, None, Ok, Warning, Error, All |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PartitionsHealthStateFilter
이 매개 변수는 더 이상 사용되지 않습니다. 대신 PartitionsFilter 매개 변수를 지정합니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ServiceName
Service Fabric 서비스의 URI를 지정합니다.
| 형식: | Uri |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-TimeoutSec
작업의 제한 시간(초)을 지정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
System.Uri
출력
System.Object