Udostępnij za pośrednictwem

Get-ServiceFabricApplicationType

  • Odwołanie
Moduł:
ServiceFabric

Pobiera typy aplikacji usługi Service Fabric zarejestrowane w klastrze usługi Service Fabric zgodne z podanymi filtrami.

Składnia

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

Opis

Polecenie cmdlet Get-ServiceFabricApplicationType pobiera zarejestrowane lub zarejestrowane w klastrze usługi Service Fabric typy aplikacji usługi Service Fabric zgodne z podanymi filtrami. Każda wersja typu aplikacji jest zwracana jako indywidualny wynik w tablicy wyników. Jeśli nie znaleziono żadnych typów aplikacji pasujących do podanych parametrów, to zapytanie nie zwraca żadnych elementów.

Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster.

Przykłady

Przykład 1. Pobieranie wszystkich zarejestrowanych lub zarejestrowanych typów aplikacji

PS C:\> Get-ServiceFabricApplicationType

To polecenie pobiera wszystkie zarejestrowane typy aplikacji.

Przykład 2. Pobieranie zarejestrowanego lub rejestrowania typu aplikacji z określonymi nazwami typów

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"

To polecenie pobiera wszystkie wersje typu aplikacji "TestApp". Nie powoduje to pobrania typu aplikacji "TestApp2", ponieważ nazwa typu aplikacji nie jest dokładnie zgodna.

Przykład 3. Pobieranie wszystkich zarejestrowanych lub rejestrujących typów aplikacji bez domyślnych parametrów aplikacji

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

To polecenie pobiera wszystkie zarejestrowane typy aplikacji. Zwrócone obiekty System.Fabric.Query.ApplicationType mają niezapełnione właściwości DefaultParameters, niezależnie od tego, czy typ aplikacji ma domyślne parametry aplikacji.

Przykład 4: Pobieranie wszystkich zarejestrowanych lub rejestrujących typów aplikacji za pomocą stronicowania, a następnie potokowanie

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

To polecenie pobiera wszystkie zarejestrowane lub rejestrujące typy aplikacji przy użyciu stronicowania. Oznacza to, że komunikaty nie są porzucane, jeśli nie mieszczą się w jednej wiadomości, której rozmiar jest określany przez konfigurację maksymalnego rozmiaru bałaganu. Stronicowanie odbywa się za kulisami przez zapytanie. Potoki i inne funkcje pozostają niezmienione.

Parametry

-ApplicationTypeDefinitionKindFilter

Określa filtr dla ApplicationTypeDefinitionKindFilter na podstawie sposobu definiowania typu aplikacji. Wartość można uzyskać z elementów członkowskich lub operacji bitowych na elementach członkowskich ApplicationTypeDefinitionKindFilter. Zwracane są tylko aplikacje zgodne z filtrem. Parametr ApplicationTypeName i ApplicationTypeDefinitionKindFilter nie można określić razem.

Typ:ApplicationTypeDefinitionKindFilter
Dopuszczalne wartości:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeName

Określa nazwę typu aplikacji usługi Service Fabric. Polecenie cmdlet pobiera wszystkie wersje określonej nazwy typu aplikacji.

Jeśli nie określisz tego parametru, to polecenie cmdlet pobierze wszystkie typy aplikacji. Ten parametr jest zgodny z nazwami typów aplikacji z uwzględnieniem wielkości liter zdefiniowanych w manifeście aplikacji aprowizowanej lub aprowizacji typów aplikacji. Na przykład wartość "Test" nie jest zgodna z wartością "TestApp", ponieważ jest to tylko częściowe dopasowanie. Ta wartość nie powinna zawierać wersji typu aplikacji i pasuje do wszystkich wersji tej samej nazwy typu aplikacji.

Parametr ApplicationTypeName i ApplicationTypeDefinitionKindFilter nie można określić razem.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeVersion

Określa wersję typu aplikacji usługi Service Fabric. Polecenie cmdlet pobiera typ aplikacji zgodny z określoną nazwą i wersją typu aplikacji.

Podaj ten parametr tylko w przypadku podania parametru ApplicationTypeName. Ten parametr wykonuje filtr na podstawie filtru ApplicationTypeName. Jest ona zgodna z wersją typu aplikacji z uwzględnieniem wielkości liter zdefiniowaną w manifeście aplikacji aprowizowanej lub aprowizowanej aplikacji. Na przykład wartość "Version" nie jest zgodna z wartością "Version1", ponieważ jest to tylko częściowe dopasowanie. Ta wartość nie powinna zawierać nazwy typu aplikacji.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ExcludeApplicationParameters

Określa, czy mają zostać wykluczone domyślne parametry aplikacji z wyniku zapytania.

W przypadku ustawienia domyślne pole parametrów aplikacji jest nadal widoczne, ale jest puste.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UsePaging

Określa, czy używać stronicowanej wersji tego zapytania.

Jeśli to zapytanie jest niestronicowane, liczba zwróconych wyników jest ograniczona przez konfigurację maksymalnego rozmiaru komunikatu. Jeśli nie zostanie określony i istnieje zbyt wiele typów aplikacji, aby zmieścić się w komunikacie, zapytanie zakończy się niepowodzeniem. Żadne wyniki nie są zwracane użytkownikowi. Jeśli zapytanie jest stronicowane, wyniki nie są porzucane z powodu ograniczeń rozmiaru komunikatów, ponieważ wyniki są podzielone na strony w razie potrzeby i w pętli. Stronicowanie odbywa się wewnętrznie przez zapytanie i nie są wymagane żadne dodatkowe kroki.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.String

Dane wyjściowe

System.Object