Get-ServiceFabricApplicationType
取得在 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
此命令會使用分頁取得所有已註冊或註冊應用程式類型。 這表示,如果訊息不符合一個訊息,其大小是由最大雜亂大小設定所決定,則不會卸載訊息。 分頁是由查詢在幕後完成。 管線和其他功能保持不變。
參數
-ApplicationTypeDefinitionKindFilter
根據定義應用程式類型的方式,指定 ApplicationTypeDefinitionKindFilter 的篩選。 您可以從 ApplicationTypeDefinitionKindFilter成員的成員或位作業取得此值。 只會傳回符合篩選準則的應用程式類型。 ApplicationTypeName 和 ApplicationTypeDefinitionKindFilter 無法同時指定。
類型: | ApplicationTypeDefinitionKindFilter |
接受的值: | Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ApplicationTypeName
指定 Service Fabric 應用程式類型的名稱。 Cmdlet 會取得您指定之應用程式類型名稱的所有版本。
如果您未指定此參數,此 Cmdlet 會取得所有應用程式類型。 此參數會與所有已布建或布建應用程式類型的應用程式資訊清單中定義的區分大小寫的確切應用程式類型名稱相符。 例如,「Test」 值不符合 「TestApp」,因為它只是部分相符專案。 此值不應包含應用程式類型的版本,且符合相同應用程式類型名稱的所有版本。
ApplicationTypeName 和 ApplicationTypeDefinitionKindFilter 無法同時指定。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ApplicationTypeVersion
指定 Service Fabric 應用程式類型的版本。 Cmdlet 會取得符合指定之應用程式類型名稱和版本的應用程式類型。
只有在也提供 ApplicationTypeName 參數時,才提供此參數。 此參數會在 ApplicationTypeName 篩選準則頂端執行篩選。 它會與已布建或布建應用程式類型的應用程式資訊清單中所定義的區分大小寫的確切應用程式類型版本相符。 例如,值 「Version」 不符合 「Version1」,因為它只是部分相符專案。 此值不應包含應用程式類型的名稱。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-ExcludeApplicationParameters
指定是否要從查詢結果中排除預設應用程式參數。
如果設定,預設應用程式參數欄位仍會顯示,但空白。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-TimeoutSec
指定作業的逾時期間,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UsePaging
指定是否要使用這個查詢的分頁版本。
如果取消分頁此查詢,傳回的結果數目會受限於訊息大小上限設定。 如果未指定,而且有太多應用程式類型無法放入訊息中,查詢就會失敗。 不會將結果傳回給使用者。 如果查詢已分頁,則不會因為訊息大小限制而捨棄結果,因為結果會在需要時分成頁面並迴圈執行。 分頁是由查詢在內部完成,不需要執行任何其他步驟。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
System.String
輸出
System.Object