Get-ServiceFabricApplicationType

取得在 Service Fabric 叢集上註冊的 Service Fabric 應用程式類型,其符合所提供的篩選準則。

Syntax

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

此命令會使用分頁取得所有已註冊或註冊應用程式類型。 這表示,如果訊息不符合一個訊息,其大小是由最大雜亂大小設定所決定,則不會卸載訊息。 分頁是由查詢在幕後完成。 管線和其他功能保持不變。

參數

-ApplicationTypeDefinitionKindFilter

根據定義應用程式類型的方式,指定 ApplicationTypeDefinitionKindFilter 的篩選。 您可以從 ApplicationTypeDefinitionKindFilter成員的成員或位作業取得此值。 只會傳回符合篩選準則的應用程式類型。 ApplicationTypeName 和 ApplicationTypeDefinitionKindFilter 無法同時指定。

Type:ApplicationTypeDefinitionKindFilter
Accepted values:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeName

指定 Service Fabric 應用程式類型的名稱。 Cmdlet 會取得您指定之應用程式類型名稱的所有版本。

如果您未指定此參數,此 Cmdlet 會取得所有應用程式類型。 此參數會與所有已布建或布建應用程式類型的應用程式資訊清單中定義的區分大小寫的確切應用程式類型名稱相符。 例如,「Test」 值不符合 「TestApp」,因為它只是部分相符專案。 此值不應包含應用程式類型的版本,且符合相同應用程式類型名稱的所有版本。

ApplicationTypeName 和 ApplicationTypeDefinitionKindFilter 無法同時指定。

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

-ApplicationTypeVersion

指定 Service Fabric 應用程式類型的版本。 Cmdlet 會取得符合指定之應用程式類型名稱和版本的應用程式類型。

只有在也提供 ApplicationTypeName 參數時,才提供此參數。 此參數會在 ApplicationTypeName 篩選準則頂端執行篩選。 它會與已布建或布建應用程式類型的應用程式資訊清單中所定義的區分大小寫的確切應用程式類型版本相符。 例如,值 「Version」 不符合 「Version1」,因為它只是部分相符專案。 此值不應包含應用程式類型的名稱。

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExcludeApplicationParameters

指定是否要從查詢結果中排除預設應用程式參數。

如果設定,預設應用程式參數欄位仍會顯示,但空白。

Type:SwitchParameter
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

-UsePaging

指定是否要使用這個查詢的分頁版本。

如果取消分頁此查詢,傳回的結果數目會受限於訊息大小上限設定。 如果未指定,而且有太多應用程式類型無法放入訊息中,查詢就會失敗。 不會將結果傳回給使用者。 如果查詢已分頁,則不會因為訊息大小限制而捨棄結果,因為結果會在需要時分成頁面並迴圈執行。 分頁是由查詢在內部完成,不需要執行任何其他步驟。

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

輸入

System.String

輸出

System.Object