Get-ServiceFabricDeployedApplication
지정된 노드에서 Service Fabric 애플리케이션을 가져옵니다.
구문
Get-ServiceFabricDeployedApplication
[-NodeName] <String>
[[-ApplicationName] <Uri>]
[-UsePaging]
[-GetSinglePage]
[-IncludeHealthState]
[-MaxResults <Int64>]
[-ContinuationToken <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Get-ServiceFabricDeployedApplication
[-NodeName] <String>
[[-ApplicationName] <Uri>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Get-ServiceFabricDeployedApplication cmdlet은 지정된 노드에 배포된 Service Fabric 애플리케이션을 가져옵니다.
Service Fabric은 배포된 각 애플리케이션에 대해 노드에 작업, 로그 및 임시 디렉터리를 만듭니다.
디렉터리 이름에 애플리케이션 ID가 포함되어 있으므로 디렉터리 이름을 추측할 수 없습니다.
배포된 애플리케이션 서비스는 지속형 데이터를 WorkDirectory저장합니다. 디버깅 또는 진단 목적으로 다른 애플리케이션 또는 프로세스가 WorkDirectory위치를 알고 있어야 할 수 있습니다.
배포된 애플리케이션 서비스는 Service Fabric에서 만든 LogDirectory 로그를 저장해야 합니다. 로그 파일의 사용자 지정 업로더는 위치를 알아야 할 수 있습니다. 특정 노드의 애플리케이션이 예상대로 작동하지 않는 경우 진단 목적으로도 LogDirectory 위치가 필요할 수 있습니다.
기본적으로 이 쿼리는 최대 메시지 크기 구성으로 제한된 여러 결과를 반환합니다. SDK 및 클러스터 버전 6.1 이상에서는 이 제한을 제거하는 페이징 기능을 지원합니다. 이 쿼리는 반환된 모든 페이지를 투명하게 반복하므로 최대 메시지 크기 구성에 관계없이 결과를 반환하는 새로운 동작입니다. 페이징 및 기타 새 기능을 사용하려면 매개 변수 집합 "UsePagedAPI"를 참조하세요. 새 필터를 선택하면 쿼리에 신호를 전송하여 내부적으로 페이징을 사용합니다. 그렇지 않은 경우 "UsePaging"를 선택하여 페이징된 쿼리를 옵트인합니다.
Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.
예제
예제 1: 애플리케이션 "fabric:/samples/CalcApp2" 가져오기
PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2
ApplicationName : fabric:/samples/CalcApp2
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState : Unknown이 명령은 배포된 애플리케이션을 반환합니다.
이 예제에서
예제 2: 애플리케이션 "fabric:/samples/VQueueApp2" 가져오기
PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2
ApplicationName : fabric:/samples/VQueueApp2
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState : Unknown이 명령은 배포된 애플리케이션을 반환합니다. 이 예제에서 DeployedApplicationStatus 다운로드 중이므로 명령은 WorkDirectory, LogDirectory및 TempDirectory대해 null 값을 반환합니다.
예제 3: 최대 결과를 사용하여 애플리케이션 가져오기
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose
ApplicationName : fabric:/samples/CalculatorApp
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState : Unknown
ApplicationName : fabric:/samples/PQueueApp1
ApplicationTypeName : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState : Unknown
VERBOSE: Continuation Token: fabric:/samples/PQueueApp1이 명령은 페이지에 맞는 클러스터의 제공된 노드에 배포된 모든 Service Fabric 애플리케이션을 가져옵니다. MaxResults 매개 변수에 의해 구성된 페이지 크기는 두 개의 항목으로 더 제한됩니다. "GetSinglePage" 옵션을 선택했으므로 이 쿼리는 결과의 한 페이지만 반환합니다. 이 옵션 없이는 MaxResults를 사용할 수 없습니다. "자세한 정보 표시"를 선택하면 반환된 연속 토큰 값이 출력됩니다. 이 값은 후속 쿼리에서 결과의 다음 페이지를 가져오는 데 사용할 수 있습니다. 반환된 결과를 저장하고 "ContinuationToken" 속성에 액세스하여 반환된 연속 토큰에 액세스할 수도 있습니다. "ContinuationToken" 속성이 null이면 반환된 연속 토큰이 없습니다.
예제 4: 연속 토큰을 사용하여 애플리케이션 가져오기
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging
ApplicationName : fabric:/samples/VQueueApp1
ApplicationTypeName : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState : Unknown이 명령은 단일 페이지에 맞는 제공된 연속 토큰을 준수하는 Service Fabric 애플리케이션을 가져옵니다. 이 쿼리에 제공된 연속 토큰은 위의 예제에서 반환된 토큰과 동일합니다. 이 예제 클러스터에는 연속 토큰을 존중하는 항목이 하나만 있습니다. 노드에서 제공된 연속 토큰이 결과의 한 페이지에 맞지 않는 애플리케이션이 너무 많으면 이 쿼리 구성은 반환된 모든 페이지의 컴파일을 반환하여 투명하게 반복합니다. 그러면 쿼리가 모든 결과의 벡터를 반환합니다. 결과의 한 페이지만 얻으려면 "GetSinglePage" 옵션을 선택합니다.
예제 5: 상태의 애플리케이션 가져오기
PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState
ApplicationName : fabric:/samples/CalculatorApp
ApplicationTypeName : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState : Ok이 명령은 제공된 애플리케이션 이름과 일치하고 해당 상태를 포함하는 Service Fabric 애플리케이션을 가져옵니다.
매개 변수
-ApplicationName
Service Fabric 애플리케이션의 URI(Uniform Resource Identifier)를 지정합니다. cmdlet은 지정된 애플리케이션 이름과 일치하는 배포된 애플리케이션을 가져옵니다. 이 쿼리는 정확히 일치합니다. 예를 들어 URI 패브릭:/App은 fabric:/App1과 일치하지 않습니다. 애플리케이션 이름이 제공되면 최대 하나의 결과가 반환됩니다. 제공된 애플리케이션 이름이 노드의 애플리케이션과 일치하지 않으면 쿼리는 null을 반환합니다.
| 형식: | Uri |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ContinuationToken
쿼리 결과의 다음 페이지를 검색하는 데 사용할 수 있는 연속 토큰을 지정합니다.
너무 많은 결과가 제공된 필터를 준수하는 경우 하나의 메시지에 맞지 않을 수 있습니다. 페이징은 반환된 결과의 컬렉션을 별도의 페이지로 분할하여 이를 고려하는 데 사용됩니다. 연속 토큰은 이전 페이지가 중단된 위치를 파악하는 데 사용되며 쿼리 자체에만 중요도를 전달합니다. 이 값은 이 쿼리를 실행하여 생성해야 하며 후속 페이지를 가져오기 위해 다음 쿼리 요청에 전달될 수 있습니다. null이 아닌 연속 토큰 값은 후속 페이지가 있는 경우에만 결과의 일부로 반환됩니다. 이 값이 -GetSinglePage 옵션 없이 제공된 경우 쿼리는 연속 토큰 값에서 시작하는 모든 페이지를 반환합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-GetSinglePage
쿼리가 연속 토큰 값을 사용하여 쿼리 결과의 한 페이지를 반환할지, 아니면 모든 페이지를 하나의 결과 목록으로 결합할지를 지정합니다. 이 옵션을 선택하면 후속 페이지를 확인하는 것은 쿼리 호출자의 책임입니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IncludeHealthState
쿼리가 배포된 애플리케이션의 상태를 반환할지 여부를 지정합니다. 이 매개 변수를 지정하지 않으면 반환된 상태가 "알 수 없음"입니다. 이 옵션을 선택하면 결과가 병합되기 전에 쿼리가 노드 및 상태 시스템 서비스와 병렬로 진행됩니다. 따라서 쿼리 비용이 더 많이 들고 시간이 더 오래 걸릴 수 있습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxResults
페이지당 반환할 수 있는 결과 항목의 최대 수를 지정합니다. 최소값이 아니라 반환된 결과 수에 대한 상한을 정의합니다. 예를 들어 페이지가 구성에 정의된 최대 메시지 크기 제한에 따라 최대 1,000개의 반환된 항목에 맞고 MaxResults 값이 2000으로 설정된 경우 2000개의 결과 항목이 쿼리 설명과 일치하더라도 1000개의 결과만 반환됩니다.
이 값을 사용하려면 GetSinglePage 플래그를 선택해야 합니다. 그렇지 않으면 무시됩니다.
| 형식: | Int64 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NodeName
Service Fabric 노드의 이름을 지정합니다. cmdlet은 지정한 노드에 배포된 애플리케이션을 가져옵니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-TimeoutSec
작업의 제한 시간(초)을 지정합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UsePaging
쿼리를 페이징할지 여부를 지정합니다. 선택하지 않으면 최대 메시지 크기 구성에 정의된 대로 한 페이지에 맞지 않는 결과가 너무 많은 경우 이 쿼리가 작동하지 않습니다. 이 옵션을 선택하면 최대 메시지 크기 구성에 관계없이 모든 결과를 반환하도록 이 쿼리가 구성됩니다. 페이징된 결과를 가져오고 호출자를 대신하여 모든 페이지를 투명하게 반복하여 이 작업을 수행합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
System.String
System.Uri
출력
System.Object