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     : {}

此命令會取得 Service Fabric 應用程式，其類型名稱為 PersistentQueueApp。

範例 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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ApplicationName

指定 Service Fabric 應用程式的統一資源識別碼（URI）。 Cmdlet 會取得具有指定 URI 的應用程式。最多可以指定一個 ApplicationName、ApplicationTypeName 或 ApplicationDefinitionKindFilter。如果未指定任何篩選，則會傳回所有應用程式。

類型:	Uri
Position:	0
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ApplicationTypeName

指定要查詢的應用程式類型名稱。最多可以指定一個 ApplicationName、ApplicationTypeName 或 ApplicationDefinitionKindFilter。如果未指定任何篩選，則會傳回所有應用程式。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-ContinuationToken

指定接續令牌，可用來擷取查詢結果的下一頁。

如果太多結果遵守提供的篩選條件，它們可能無法放入一則訊息中。分頁是用來將傳回結果的集合分割成個別頁面來說明這一點。接續標記用來知道上一頁離開的位置，只對查詢本身具有重要性。此值應該從執行此查詢產生，並可以傳遞至下一個查詢要求，以取得後續頁面。只有在有後續頁面時，才會傳回非 Null 接續令牌值做為結果的一部分。如果沒有 -GetSinglePage 選項提供這個值，則查詢會從接續令牌值開始傳回所有頁面。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ExcludeApplicationParameters

指定是否將應用程式參數從結果中排除。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GetSinglePage

指定查詢會傳回一頁具有接續令牌值的查詢結果，或合併成一份結果清單的所有頁面。如果選取此選項，則查詢的呼叫端負責檢查後續頁面。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-MaxResults

指定每個頁面可傳回的結果項目數目上限。這會定義所傳回結果數目的上限，而不是最小值。例如，如果頁面最多符合 1000 個傳回的專案，則根據組態中定義的訊息大小限制，且 MaxResults 值設定為 2000，則即使 2000 個結果專案符合查詢描述，也會傳回 1000 個結果。此值需要選取 GetSinglePage 旗標;否則會忽略它。

類型:	Int64
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TimeoutSec

指定作業的逾時期間，以秒為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

System.Uri

System.String

輸出

System.Object

共用方式為

Get-ServiceFabricApplication

語法

Description

範例

範例 1：取得所有應用程式

範例 2：依名稱取得應用程式

範例 3：依類型名稱取得應用程式

範例 4：依定義種類取得應用程式

範例 5：取得具有最大結果的應用程式

範例 6：使用接續令牌取得應用程式

範例 7：排除應用程式參數時依名稱取得應用程式

參數

-ApplicationDefinitionKindFilter

-ApplicationName

-ApplicationTypeName

-ContinuationToken

-ExcludeApplicationParameters

-GetSinglePage

-MaxResults

-TimeoutSec

輸入

輸出

其他資源

共用方式為

Get-ServiceFabricApplication

語法

Description

範例

範例 1：取得所有應用程式

範例 2：依名稱取得應用程式

範例 3：依類型名稱取得應用程式

範例 4：依定義種類取得應用程式

範例 5：取得具有最大結果的應用程式

範例 6：使用接續令牌取得應用程式

範例 7：排除應用程式參數時依名稱取得應用程式

參數

-ApplicationDefinitionKindFilter

-ApplicationName

-ApplicationTypeName

-ContinuationToken

-ExcludeApplicationParameters

-GetSinglePage

-MaxResults

-TimeoutSec

輸入

輸出

相關連結

其他資源