Sdílet prostřednictvím

Get-ServiceFabricApplicationType

  • Reference
Modul:
ServiceFabric

Získá typy aplikací Service Fabric zaregistrované v clusteru Service Fabric, které odpovídají zadaným filtrům.

Syntaxe

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

Description

Rutina Get-ServiceFabricApplicationType získá zaregistrované nebo zaregistrované typy aplikací Service Fabric v clusteru Service Fabric, které odpovídají zadaným filtrům. Každá verze typu aplikace se vrátí jako jednotlivý výsledek ve výsledném poli. Pokud nejsou nalezeny žádné typy aplikací odpovídající zadaným parametrům, tento dotaz nevrací nic.

Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster.

Příklady

Příklad 1: Získání všech registrovaných nebo registrací typů aplikací

PS C:\> Get-ServiceFabricApplicationType

Tento příkaz získá všechny registrované typy aplikací.

Příklad 2: Získání zaregistrovaného nebo registračního typu aplikace se zadanými názvy typů

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"

Tento příkaz získá všechny verze aplikace typu TestApp. Tím se nezískáte typ aplikace TestApp2, protože název typu aplikace není přesná shoda.

Příklad 3: Získání všech registrovaných nebo registrací typů aplikací bez výchozích parametrů aplikace

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

Tento příkaz získá všechny registrované typy aplikací. Vrácené System.Fabric.Query.ApplicationType objekty mají nenapsanou vlastnost DefaultParameters bez ohledu na to, zda typ aplikace má výchozí parametry aplikace.

Příklad 4: Získání všech registrovaných nebo registrací typů aplikací se stránkováním a následným propojením

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

Tento příkaz získá všechny registrované nebo registrované typy aplikací pomocí stránkování. To znamená, že zprávy se neodhodí, pokud se nevejdou do jedné zprávy, jejíž velikost je určena konfigurací maximální velikosti messaage. Stránkování provádí dotaz na pozadí. Potrubí a další funkce zůstávají beze změny.

Parametry

-ApplicationTypeDefinitionKindFilter

Určuje filtr pro ApplicationTypeDefinitionKindFilter na základě způsobu definování typu aplikace. Hodnotu lze získat ze členů nebo bitové operace u členů ApplicationTypeDefinitionKindFilter. Vrátí se pouze typ aplikací, které odpovídají filtru. ApplicationTypeName a ApplicationTypeDefinitionKindFilter nelze zadat společně.

Typ:ApplicationTypeDefinitionKindFilter
Přípustné hodnoty:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeName

Určuje název typu aplikace Service Fabric. Rutina získá všechny verze zadaného názvu typu aplikace.

Pokud tento parametr nezadáte, získá tato rutina všechny typy aplikací. Tento parametr odpovídá přesnému názvu typu aplikace definovanému v manifestu aplikace pro všechny zřízené nebo zřizovací typy aplikací. Například hodnota "Test" neodpovídá "TestApp", protože se jedná pouze o částečnou shodu. Tato hodnota by neměla obsahovat verzi typu aplikace a odpovídá všem verzím stejného názvu typu aplikace.

ApplicationTypeName a ApplicationTypeDefinitionKindFilter nelze zadat společně.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ApplicationTypeVersion

Určuje verzi typu aplikace Service Fabric. Rutina získá typ aplikace, který odpovídá zadanému názvu a verzi typu aplikace.

Tento parametr zadejte pouze v případě, že poskytujete také parametr ApplicationTypeName. Tento parametr provádí filtr nad filtrem ApplicationTypeName. Odpovídá verzi přesného typu aplikace s rozlišováním velkých a malých písmen definovanou v manifestu aplikace zřízeného nebo zřizovacího typu aplikace. Například hodnota "Version" neodpovídá "Version1", protože se jedná pouze o částečnou shodu. Tato hodnota by neměla obsahovat název typu aplikace.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ExcludeApplicationParameters

Určuje, jestli se mají vyloučit výchozí parametry aplikace z výsledku dotazu.

Pokud je nastaveno, pole výchozích parametrů aplikace je stále viditelné, ale je prázdné.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeoutSec

Určuje časový limit operace v sekundách.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UsePaging

Určuje, jestli se má použít stránkovaná verze tohoto dotazu.

Pokud tento dotaz není stránkovaný, počet vrácených výsledků je omezen konfigurací maximální velikosti zprávy. Pokud není zadáno a existuje příliš mnoho typů aplikací, aby se vešly do zprávy, dotaz selže. Uživateli se nevrátí žádné výsledky. Pokud je dotaz stránkovaný, výsledky se neodstraní kvůli omezením velikosti zprávy, protože výsledky se v případě potřeby rozdělí na stránky a projdou smyčkou. Stránkování provádí dotaz interně a nevyžaduje se žádné další kroky.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

System.String

Výstupy

System.Object