다음을 통해 공유

Get-ServiceFabricApplication

  • 참조
모듈:
ServiceFabric

Service Fabric 클러스터에서 애플리케이션을 가져옵니다.

구문

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-ContinuationToken <String>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Get-ServiceFabricApplication cmdlet은 Service Fabric 클러스터에서 애플리케이션을 가져옵니다. 기본적으로 최대 메시지 크기 구성에 관계없이 이 쿼리에서 반환할 수 있는 쿼리 결과 수에는 제한이 없습니다. REST 또는 C# 동등한 호출과 달리 페이징된 쿼리이지만 이 쿼리의 기본 동작은 반환된 모든 페이지를 투명하게 반복하는 것입니다. GetSinglePage 옵션은 단일 페이지를 반환하도록 이 쿼리를 구성합니다.

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

예제

예제 1: 모든 애플리케이션 가져오기

PS C:\> Get-ServiceFabricApplication

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : { "ServiceInstanceCount" = "4" }

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

이 명령은 클러스터의 모든 애플리케이션을 가져옵니다.

예제 2: 이름으로 애플리케이션 가져오기

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/samples/PQueueApp1

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

이 명령은 fabric:/samples/PQueueApp1이라는 이름의 특정 애플리케이션을 가져옵니다.

예제 3: 형식 이름으로 애플리케이션 가져오기

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

이 명령은 형식 이름이 PersistentQueueApp인 Service Fabric 애플리케이션을 가져옵니다.

예제 4: 정의 종류별 애플리케이션 가져오기

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

이 명령은 Service Fabric 애플리케이션 설명에 의해 정의된 Service Fabric 애플리케이션을 가져옵니다.

예제 5: 최대 결과를 사용하여 애플리케이션 가져오기

PS C:\>Get-ServiceFabricApplication -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : "ServiceInstanceCount" = "4"
                            

VERBOSE: Continuation Token: fabric:/samples/CalculatorAppWithAppParameters

이 명령은 페이지에 맞는 클러스터의 모든 Service Fabric 애플리케이션을 가져옵니다. 클러스터에 더 많은 애플리케이션이 있지만 MaxResults 매개 변수에 의해 구성된 대로 두 개의 결과만 반환됩니다. 페이지에 맞지 않는 결과가 있으므로 후속 페이지의 존재를 나타내는 연속 토큰 값이 반환됩니다.

예제 6: 연속 토큰을 사용하여 애플리케이션 가져오기

PS C:\>Get-ServiceFabricApplication -ContinuationToken fabric:/samples/CalculatorAppWithAppParameters -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

VERBOSE: Continuation Token:

이 명령은 단일 페이지에 맞는 제공된 연속 토큰을 준수하는 Service Fabric 애플리케이션을 가져옵니다. 이 쿼리에 제공된 연속 토큰은 위의 예제에서 반환된 토큰과 동일합니다. "자세한 정보 표시" 옵션은 더 이상 페이지를 사용할 수 없음을 나타내는 연속 토큰을 표시하지 않습니다.

예제 7: 애플리케이션 매개 변수를 제외하는 동안 이름으로 애플리케이션 가져오기

PS C:\>Get-ServiceFabricApplication -ApplicationName fabric:/samples/CalculatorAppWithAppParameters -ExcludeApplicationParameters

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

이 명령은 제공된 애플리케이션 이름과 일치하는 Service Fabric 애플리케이션을 가져옵니다. 예제 5에서 볼 수 있듯이 이 애플리케이션에는 애플리케이션 매개 변수가 있지만 "ExcludeApplicationParameters" 플래그 때문에 반환된 결과에서 제외됩니다.

매개 변수

-ApplicationDefinitionKindFilter

애플리케이션이 정의되는 방식에 따라 ApplicationDefinitionKindFilter 대한 필터를 지정합니다. 이 값은 ApplicationDefinitionKindFilter멤버 또는 비트 연산에서 가져올 수 있습니다. 필터와 일치하는 애플리케이션만 반환됩니다. ApplicationName, ApplicationTypeName 또는 ApplicationDefinitionKindFilter 중 하나만 지정할 수 있습니다. 필터를 지정하지 않으면 모든 애플리케이션이 반환됩니다.

형식:ApplicationDefinitionKindFilter
허용되는 값:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ApplicationName

Service Fabric 애플리케이션의 URI(Uniform Resource Identifier)를 지정합니다. cmdlet은 지정된 URI가 있는 애플리케이션을 가져옵니다. ApplicationName, ApplicationTypeName 또는 ApplicationDefinitionKindFilter 중 하나만 지정할 수 있습니다. 필터를 지정하지 않으면 모든 애플리케이션이 반환됩니다.

형식:Uri
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ApplicationTypeName

쿼리할 애플리케이션을 필터링하는 데 사용되는 애플리케이션 유형 이름을 지정합니다. ApplicationName, ApplicationTypeName 또는 ApplicationDefinitionKindFilter 중 하나만 지정할 수 있습니다. 필터를 지정하지 않으면 모든 애플리케이션이 반환됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ContinuationToken

쿼리 결과의 다음 페이지를 검색하는 데 사용할 수 있는 연속 토큰을 지정합니다.

너무 많은 결과가 제공된 필터를 준수하는 경우 하나의 메시지에 맞지 않을 수 있습니다. 페이징은 반환된 결과의 컬렉션을 별도의 페이지로 분할하여 이를 고려하는 데 사용됩니다. 연속 토큰은 이전 페이지가 중단된 위치를 파악하는 데 사용되며 쿼리 자체에만 중요도를 전달합니다. 이 값은 이 쿼리를 실행하여 생성해야 하며 후속 페이지를 가져오기 위해 다음 쿼리 요청에 전달될 수 있습니다. null이 아닌 연속 토큰 값은 후속 페이지가 있는 경우에만 결과의 일부로 반환됩니다. 이 값이 -GetSinglePage 옵션 없이 제공된 경우 쿼리는 연속 토큰 값에서 시작하는 모든 페이지를 반환합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ExcludeApplicationParameters

애플리케이션 매개 변수를 결과에서 제외할지 여부를 지정합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-GetSinglePage

쿼리가 연속 토큰 값을 사용하여 쿼리 결과의 한 페이지를 반환할지, 아니면 모든 페이지를 하나의 결과 목록으로 결합할지를 지정합니다. 이 옵션을 선택하면 후속 페이지를 확인하는 것은 쿼리 호출자의 책임입니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MaxResults

페이지당 반환할 수 있는 결과 항목의 최대 수를 지정합니다. 최소값이 아니라 반환된 결과 수에 대한 상한을 정의합니다. 예를 들어 페이지가 구성에 정의된 최대 메시지 크기 제한에 따라 최대 1,000개의 반환된 항목에 맞고 MaxResults 값이 2000으로 설정된 경우 2000개의 결과 항목이 쿼리 설명과 일치하더라도 1000개의 결과만 반환됩니다. 이 값을 사용하려면 GetSinglePage 플래그를 선택해야 합니다. 그렇지 않으면 무시됩니다.

형식:Int64
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TimeoutSec

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

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

System.Uri

System.String

출력

System.Object