Get-ServiceFabricApplicationHealth

Service Fabric 애플리케이션의 상태를 가져옵니다.

Syntax

Get-ServiceFabricApplicationHealth
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyDeployedApplications <Byte>]
   [-MaxPercentUnhealthyServices <Byte>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicesHealthStateFilter <Int64>]
   [-ServicesFilter <HealthStateFilter>]
   [-DeployedApplicationsHealthStateFilter <Int64>]
   [-DeployedApplicationsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Get-ServiceFabricApplicationHealth cmdlet은 Service Fabric 애플리케이션의 상태를 가져옵니다. Service Fabric은 다음과 같은 상태를 보고합니다.

  • OK. 엔터티는 상태 지침을 충족합니다.
  • 오류. 엔터티가 상태 지침을 충족하지 않습니다.
  • 경고. 엔터티는 상태 지침을 충족하지만 몇 가지 문제가 발생했습니다.

상태 저장소에서 엔터티를 찾을 수 없는 경우 이 cmdlet은 오류를 반환합니다.

Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.

예제

예제 1: 애플리케이션의 상태 가져오기

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist

이 명령은 명명된 애플리케이션의 상태를 쿼리합니다.

예제 2: 사용자 지정 상태 정책을 사용하여 애플리케이션의 상태 가져오기 및 필터 반환

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ConsiderWarningAsError $True -EventsFilter Error -ServicesFilter 'Error,Warning' -DeployedApplicationsFilter 'Warning,Error'

이 명령은 명명된 애플리케이션의 상태를 쿼리합니다. 이 명령은 상태 정책의 값을 지정하고 필터를 사용하여 오류 이벤트와 오류 또는 경고 상태의 자식만 반환합니다.

예제 3: 애플리케이션의 상태를 가져와서 상태 통계 제외

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ExcludeHealthStatistics

이 명령은 명명된 애플리케이션의 상태를 쿼리합니다. 반환된 애플리케이션 상태에는 상태 통계가 포함되지 않습니다.

매개 변수

-ApplicationName

Service Fabric 애플리케이션의 URI(Uniform Resource Identifier)를 지정합니다. cmdlet은 지정한 URI가 있는 애플리케이션에 대한 상태 정보를 가져옵니다.

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

-ConsiderWarningAsError

이 cmdlet이 상태 평가 중에 경고 상태 보고서를 오류로 간주하는지 여부를 나타냅니다.

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

-DeployedApplicationsFilter

상태에 따라 DeployedApplicationHealthState 자식에 대한 필터를 지정합니다. 이 값은 HealthStateFilter의 멤버에 대한 멤버 또는 비트 연산에서 가져옵니다. 필터와 일치하는 자식만 반환됩니다. 모든 자식은 애플리케이션 집계 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeployedApplicationsHealthStateFilter

이 매개 변수는 더 이상 사용되지 않습니다. 대신 DeployedApplicationsFilter 매개 변수를 지정합니다.

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

-EventsFilter

상태 상태에 따라 애플리케이션에 보고된 HealthEvent 개체 컬렉션에 대한 필터를 지정합니다. 이 값은 HealthStateFilter의 멤버에 대한 멤버 또는 비트 연산에서 가져올 수 있습니다. 필터와 일치하는 이벤트만 반환됩니다. 모든 이벤트는 애플리케이션 집계 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsHealthStateFilter

이 매개 변수는 더 이상 사용되지 않습니다. 대신 EventsFilter 매개 변수를 지정합니다.

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

-ExcludeHealthStatistics

상태 통계를 쿼리 결과에 포함할지 여부를 나타냅니다. 지정한 경우 상태 통계는 쿼리 결과의 일부로 반환되지 않습니다. 그렇지 않으면 쿼리 결과에는 이 애플리케이션의 서비스, 파티션 및 복제본이 Ok, Warning 및 Error 상태인 수에 대한 정보가 포함된 애플리케이션 상태 통계가 포함됩니다.

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

-MaxPercentUnhealthyDeployedApplications

클러스터의 노드에 배포된 비정상 애플리케이션 인스턴스의 최대 허용 비율을 지정합니다. 상태 오류가 허용되는 것보다 많은 배포된 애플리케이션이 있는 경우 애플리케이션의 상태가 오류입니다. 이 매개 변수를 지정하지 않으면 상태 평가에서 애플리케이션 매니페스트에 제공된 값을 사용합니다.

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

-MaxPercentUnhealthyPartitionsPerService

비정상 서비스 파티션의 최대 허용 비율을 지정합니다. 상태 오류가 허용되는 것보다 많은 파티션이 있는 경우 서비스의 상태가 오류입니다. 이 매개 변수를 지정하지 않으면 상태 평가에서 애플리케이션 매니페스트에 제공된 값을 사용합니다.

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

-MaxPercentUnhealthyReplicasPerPartition

비정상 파티션 복제본의 최대 허용 비율을 지정합니다. 상태 오류가 허용되는 것보다 많은 복제본이 있는 경우 파티션의 상태가 오류입니다. 이 매개 변수를 지정하지 않으면 상태 평가에서 애플리케이션 매니페스트에 제공된 값을 사용합니다.

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

-MaxPercentUnhealthyServices

애플리케이션에서 허용되는 비정상 서비스의 최대 백분율을 지정합니다. 허용된 것보다 상태 오류가 있는 서비스가 더 많은 경우 애플리케이션의 상태가 오류입니다. 이 매개 변수를 지정하지 않으면 상태 평가에서 애플리케이션 매니페스트에 제공된 값을 사용합니다.

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

-ServicesFilter

상태에 따라 ServiceHealthState 자식에 대한 필터를 지정합니다. 이 값은 HealthStateFilter의 멤버에 대한 멤버 또는 비트 연산에서 가져올 수 있습니다. 필터와 일치하는 자식만 반환됩니다. 모든 자식은 애플리케이션 집계 상태를 평가하는 데 사용됩니다. 지정하지 않으면 모든 항목이 반환됩니다.

Type:HealthStateFilter
Accepted values:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServicesHealthStateFilter

이 매개 변수는 더 이상 사용되지 않습니다. 대신 ServicesFilter 매개 변수를 지정합니다.

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

-TimeoutSec

작업의 제한 시간(초)을 지정합니다.

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

입력

System.Uri

출력

System.Object