Udostępnij za pośrednictwem

Get-ServiceFabricDeployedApplication

  • Odwołanie
Moduł:
ServiceFabric

Pobiera aplikacje usługi Service Fabric w określonym węźle.

Składnia

Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-UsePaging]
   [-GetSinglePage]
   [-IncludeHealthState]
   [-MaxResults <Int64>]
   [-ContinuationToken <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricDeployedApplication
   [-NodeName] <String>
   [[-ApplicationName] <Uri>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-ServiceFabricDeployedApplication pobiera aplikacje usługi Service Fabric wdrożone w określonym węźle.

Usługa Service Fabric tworzy katalogi robocze, dzienniki i tymczasowe w węźle dla każdej wdrożonej aplikacji. Ponieważ nazwy katalogów zawierają identyfikator aplikacji, nie można odgadnąć nazw katalogów. Gdy parametr DeployedApplicationStatus jest aktywny, funkcja Get-ServiceFabricDeployedApplication zwraca nazwy katalogów w zwracanych wartościach WorkDirectory, LogDirectory i TempDirectory . Gdy parametr DeployedApplicationStatus jest pobierany , wartości WorkDirectory, LogDirectory iTempDirectory mają wartość null.

Wdrożone usługi aplikacji przechowują utrwalone dane w usłudze WorkDirectory. W celach debugowania lub diagnostyki może być konieczne poznanie lokalizacji usługi WorkDirectory przez inną aplikację lub proces.

Wdrożone usługi aplikacji powinny przechowywać swoje dzienniki w usłudze LogDirectory utworzonej przez usługę Service Fabric. Może być konieczne zapoznanie się z lokalizacją niestandardowego modułu przekazującego pliki dziennika. Lokalizacja usługi LogDirectory może być potrzebna do celów diagnostycznych, a także wtedy, gdy aplikacja w określonym węźle nie działa zgodnie z oczekiwaniami.

Domyślnie to zapytanie zwraca wiele wyników ograniczonych do maksymalnej konfiguracji rozmiaru komunikatu. Zestawy SDK i klastry w wersji 6.1 lub nowszej obsługują funkcje stronicowania, które usuwa to ograniczenie; nowe zachowanie będzie zwracać wyniki niezależnie od maksymalnej konfiguracji rozmiaru komunikatu, ponieważ to zapytanie jest przekazywane przez wszystkie zwrócone strony w sposób niewidoczny. Aby użyć stronicowania i innych nowych funkcji, zobacz zestaw parametrów "UsePagedAPI". Wybranie wszystkich nowych sygnałów filtrów do zapytania w celu użycia stronicowania pod maską. W przeciwnym razie wybierz pozycję "UsePaging", aby wyrazić zgodę na stronicowanie zapytań.

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 aplikacji "fabric:/samples/CalcApp2"

PS C:\> Get-ServiceFabricDeployedApplication -NodeName "VIPULM4-RK01-BD01" -ApplicationName fabric:/samples/CalcApp2

ApplicationName           : fabric:/samples/CalcApp2
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\work
LogDirectory              : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\log
TempDirectory             : D:\ServiceFabric\Data\VIPULM4-RK01-BD01\Fabric\work\Applications\CalculatorApp_App5\temp
HealthState               : Unknown

To polecenie zwraca wdrożone aplikacje. W tym przykładzie wartość DeployedApplicationStatus jest aktywna i dlatego polecenie Get-ServiceFabricDeployedApplication zwraca nazwy katalogów w zwracanych wartościach WorkDirectory, LogDirectory i TempDirectory .

Przykład 2. Pobieranie aplikacji "fabric:/samples/VQueueApp2"

PS C:\> Get-ServiceFabricDeployedApplication -NodeName VIPULM4-RK01-BD01 fabric:/samples/VQueueApp2

ApplicationName           : fabric:/samples/VQueueApp2
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Downloading
HealthState               : Unknown

To polecenie zwraca wdrożone aplikacje. W tym przykładzie element DeployedApplicationStatus jest pobierany, a zatem polecenie zwraca wartości null dla elementu WorkDirectory, LogDirectory i TempDirectory.

Przykład 3. Pobieranie aplikacji z maksymalnymi wynikami

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Unknown

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\PersistentQueueApp_App1\temp
HealthState               : Unknown

VERBOSE: Continuation Token: fabric:/samples/PQueueApp1

To polecenie pobiera wszystkie aplikacje usługi Service Fabric wdrożone w podanym węźle w klastrze, które mieszczą się na stronie. Rozmiar strony jest dodatkowo ograniczony do dwóch elementów, zgodnie z konfiguracją parametru MaxResults. Ponieważ wybraliśmy opcję "GetSinglePage", to zapytanie zwróci tylko jedną stronę wyników. Nie można użyć opcji MaxResults bez tej opcji. Wybranie pozycji "Pełne" wyświetla zwróconą wartość tokenu kontynuacji. Tej wartości można użyć w kolejnym zapytaniu, aby uzyskać następną stronę wyników. Możesz również uzyskać dostęp do zwróconego tokenu kontynuacji, zapisując zwrócone wyniki i korzystając z właściwości "ContinuationToken". Właściwość "ContinuationToken" ma wartość null, nie ma zwracanego tokenu kontynuacji.

Przykład 4. Pobieranie aplikacji z tokenem kontynuacji

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ContinuationToken fabric:/samples/PQueueApp1 -UsePaging

ApplicationName           : fabric:/samples/VQueueApp1
ApplicationTypeName       : VolatileQueueApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\VolatileQueueApp_App2\temp
HealthState               : Unknown

To polecenie pobiera aplikacje usługi Service Fabric, które szanują podany token kontynuacji, który mieści się w jednej stronie. Token kontynuacji dostarczony do tego zapytania jest taki sam, który został zwrócony z powyższego przykładu. W tym przykładowym klastrze istnieje tylko jeden element, który uwzględnia token kontynuacji. Jeśli istnieje zbyt wiele aplikacji, które szanują podany token kontynuacji w węźle, aby zmieściły się na jednej stronie wyników, ta konfiguracja zapytania zwróci kompilację wszystkich zwracanych stron, w sposób niewidoczny dla nich pętlę; zapytanie zwróci następnie wektor wszystkich wyników. Aby uzyskać tylko jedną stronę wyników, wybierz opcję "GetSinglePage".

Przykład 5. Pobieranie aplikacji ze stanem kondycji

PS C:\>Get-ServiceFabricDeployedApplication -NodeName _Node_1 -ApplicationName fabric:/samples/CalculatorApp -IncludeHealthState

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
DeployedApplicationStatus : Active
WorkDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\work
LogDirectory              : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\log
TempDirectory             : C:\SfDevCluster\Data\_App\_Node_1\CalculatorApp_App0\temp
HealthState               : Ok

To polecenie pobiera aplikację usługi Service Fabric zgodną z podaną nazwą aplikacji i zawiera jej stan kondycji.

Parametry

-ApplicationName

Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric. Polecenie cmdlet pobiera wdrożona aplikacja zgodna z określoną nazwą aplikacji. To zapytanie wykonuje dokładne dopasowanie. Na przykład sieć szkieletowa identyfikatora URI:/Aplikacja nie będzie zgodna z siecią szkieletową:/App1. W przypadku podania nazwy aplikacji zostanie zwrócony co najwyżej jeden wynik. Jeśli podana nazwa aplikacji nie jest zgodna z żadną aplikacją w węźle, zapytanie zwraca wartość null.

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

-ContinuationToken

Określa token kontynuacji, który może służyć do pobierania następnej strony wyników zapytania.

Jeśli zbyt wiele wyników szanuje podane filtry, mogą nie mieścić się w jednym komunikacie. Stronicowanie jest używane do tego celu przez podzielenie kolekcji zwróconych wyników na oddzielne strony. Token kontynuacji służy do poznania miejsca, w którym została przerwana poprzednia strona, niosąc znaczenie tylko dla samego zapytania. Ta wartość powinna być generowana na podstawie uruchamiania tego zapytania i może zostać przekazana do następnego żądania zapytania, aby uzyskać kolejne strony. Wartość tokenu kontynuacji innej niż null jest zwracana w ramach wyniku tylko wtedy, gdy istnieje kolejna strona. Jeśli ta wartość zostanie podana bez opcji -GetSinglePage, zapytanie zwróci wszystkie strony rozpoczynające się od wartości tokenu kontynuacji.

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

-GetSinglePage

Określa, czy zapytanie zwróci jedną stronę wyników zapytania z wartością tokenu kontynuacji, czy wszystkie strony połączone w jedną listę wyników. Jeśli ta opcja jest zaznaczona, odpowiedzialność za obiekt wywołujący zapytanie jest odpowiedzialny za sprawdzenie kolejnych stron.

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

-IncludeHealthState

Określa, czy zapytanie zwróci stan kondycji wdrożonych aplikacji. Jeśli ten parametr nie zostanie określony, zwrócony stan kondycji to "Nieznany". Po wybraniu zapytania przechodzi równolegle do węzła i usługi systemu kondycji przed scaleniem wyników. W rezultacie zapytanie jest droższe i może potrwać dłużej.

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

-MaxResults

Określa maksymalną liczbę elementów wyników, które można zwrócić na stronę. Definiuje górną granicę liczby zwróconych wyników, a nie minimum. Jeśli na przykład strona pasuje do maksymalnie 1000 zwróconych elementów zgodnie z maksymalnymi ograniczeniami rozmiaru komunikatów zdefiniowanymi w konfiguracji, a wartość MaxResults jest ustawiona na 2000, zwracane są tylko 1000 wyników, nawet jeśli 2000 elementów wyników jest zgodne z opisem zapytania.

Ta wartość wymaga wybrania flagi GetSinglePage; zostanie zignorowana w przeciwnym razie.

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

-NodeName

Określa nazwę węzła usługi Service Fabric. Polecenie cmdlet pobiera aplikacje wdrożone w węźle określonym przez Ciebie.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
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 zapytanie zostanie stronicowane. Jeśli nie zostanie wybrane, to zapytanie nie będzie działać, gdy istnieje zbyt wiele wyników, aby zmieścić się na jednej stronie, zgodnie z definicją konfiguracji maksymalnego rozmiaru komunikatu. Wybranie tej opcji powoduje skonfigurowanie tego zapytania w celu zwrócenia wszystkich wyników niezależnie od konfiguracji maksymalnego rozmiaru komunikatu. Robi to, uzyskując stronicowane wyniki i w sposób niewidoczny dla wszystkich stron w imieniu obiektu wywołującego.

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

System.Uri

Dane wyjściowe

System.Object