다음을 통해 공유

Get-ServiceFabricApplicationType

  • 참조
모듈:
ServiceFabric

제공된 필터와 일치하는 Service Fabric 클러스터에 등록된 Service Fabric 애플리케이션 유형을 가져옵니다.

구문

Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationTypeDefinitionKindFilter <ApplicationTypeDefinitionKindFilter>]
   [-ExcludeApplicationParameters]
   [-UsePaging]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Get-ServiceFabricApplicationType cmdlet은 제공된 필터와 일치하는 Service Fabric 클러스터에 등록되거나 등록된 Service Fabric 애플리케이션 유형을 가져옵니다. 애플리케이션 유형의 각 버전은 결과 배열에서 개별 결과로 반환됩니다. 제공된 매개 변수와 일치하는 애플리케이션 형식이 없으면 이 쿼리는 아무 것도 반환하지 않습니다.

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

예제

예제 1: 모든 등록 또는 등록 애플리케이션 유형 가져오기

PS C:\> Get-ServiceFabricApplicationType

이 명령은 등록된 모든 애플리케이션 유형을 가져옵니다.

예제 2: 지정된 형식 이름으로 애플리케이션 형식 등록 또는 등록

PS C:\> # Scenario: multiple application types are provisioned in the cluster, including TestApp versions 1 and 2, as well as TestApp2 version 1.
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "TestApp"

이 명령은 애플리케이션 유형 "TestApp"의 모든 버전을 가져옵니다. 애플리케이션 유형 이름이 정확히 일치하지 않기 때문에 애플리케이션 유형 "TestApp2"를 얻지 못합니다.

예제 3: 기본 애플리케이션 매개 변수 없이 모든 등록 또는 등록 애플리케이션 유형 가져오기

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

이 명령은 등록된 모든 애플리케이션 유형을 가져옵니다. 반환된 System.Fabric.Query.ApplicationType 개체에는 애플리케이션 형식에 기본 애플리케이션 매개 변수가 있는지 여부에 관계없이 사용자 지정되지 않은 DefaultParameters 속성이 있습니다.

예제 4: 페이징 및 파이핑을 사용하여 모든 등록 또는 등록 애플리케이션 유형 가져오기

PS C:\> Get-ServiceFabricApplicationType -UsePaging | Get-ServiceFabricApplicationManifest

이 명령은 페이징을 사용하여 등록된 모든 애플리케이션 유형을 가져옵니다. 즉, 최대 messaage 크기 구성에 따라 크기가 결정되는 하나의 메시지에 맞지 않으면 메시지가 삭제되지 않습니다. 페이징은 쿼리를 통해 백그라운드에서 수행됩니다. 파이핑 및 기타 기능은 변경되지 않습니다.

매개 변수

-ApplicationTypeDefinitionKindFilter

애플리케이션 유형이 정의된 방식에 따라 ApplicationTypeDefinitionKindFilter 에 대한 필터를 지정합니다. 이 값은 ApplicationTypeDefinitionKindFilter의 멤버에 대한 멤버 또는 비트 연산에서 가져올 수 있습니다. 필터와 일치하는 애플리케이션 형식만 반환됩니다. ApplicationTypeName 및 ApplicationTypeDefinitionKindFilter를 함께 지정할 수 없습니다.

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

-ApplicationTypeName

Service Fabric 애플리케이션 유형의 이름을 지정합니다. cmdlet은 지정한 애플리케이션 유형 이름의 모든 버전을 가져옵니다.

이 매개 변수를 지정하지 않으면 이 cmdlet은 모든 애플리케이션 형식을 가져옵니다. 이 매개 변수는 프로비전되거나 프로비전되는 모든 애플리케이션 형식의 애플리케이션 매니페스트에 정의된 대/소문자 구분 정확한 애플리케이션 형식 이름과 일치합니다. 예를 들어 "Test" 값은 부분 일치일 뿐이므로 "TestApp"은 일치하지 않습니다. 이 값은 애플리케이션 형식의 버전을 포함해서는 안 되며 동일한 애플리케이션 유형 이름의 모든 버전과 일치합니다.

ApplicationTypeName 및 ApplicationTypeDefinitionKindFilter를 함께 지정할 수 없습니다.

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

-ApplicationTypeVersion

Service Fabric 애플리케이션 유형의 버전을 지정합니다. cmdlet은 지정된 애플리케이션 유형 이름 및 버전과 일치하는 애플리케이션 형식을 가져옵니다.

ApplicationTypeName 매개 변수를 제공하는 경우에만 이 매개 변수를 제공합니다. 이 매개 변수는 ApplicationTypeName 필터 위에 필터를 수행합니다. 프로비전 또는 프로비저닝 애플리케이션 형식의 애플리케이션 매니페스트에 정의된 대/소문자 구분 정확한 애플리케이션 유형 버전과 일치합니다. 예를 들어 "Version" 값은 부분 일치일 뿐이므로 "Version1"은 일치하지 않습니다. 이 값은 애플리케이션 형식의 이름을 포함해서는 안 됩니다.

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

-ExcludeApplicationParameters

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

설정된 경우 기본 애플리케이션 매개 변수 필드는 계속 표시되지만 비어 있습니다.

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

-TimeoutSec

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

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

-UsePaging

이 쿼리의 페이징된 버전을 사용할지 여부를 지정합니다.

이 쿼리가 페이징되지 않은 경우 반환된 결과의 수는 최대 메시지 크기 구성에 의해 제한됩니다. 지정하지 않고 메시지에 맞지 않는 애플리케이션 유형이 너무 많으면 쿼리가 실패합니다. 사용자에게 결과가 반환되지 않습니다. 쿼리가 페이징되면 필요한 경우 결과가 페이지로 나뉘어지고 반복되므로 메시지 크기가 손상되어 결과가 삭제되지 않습니다. 페이징은 쿼리를 통해 내부적으로 수행되며 추가 단계가 필요하지 않습니다.

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

입력

System.String

출력

System.Object