Sdílet prostřednictvím

Get-ServiceFabricDeployedApplication

  • Reference
Modul:
ServiceFabric

Získá aplikace Service Fabric na zadaném uzlu.

Syntaxe

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>]

Description

Rutina Get-ServiceFabricDeployedApplication získá aplikace Service Fabric nasazené na zadaný uzel.

Service Fabric vytvoří pracovní, protokolovací a dočasné adresáře na uzlu pro každou nasazenou aplikaci. Vzhledem k tomu, že názvy adresářů obsahují ID aplikace, názvy adresářů nelze uhodnout. Když je nasazená hodnota ApplicationStatus aktivní, vrátí funkce Get-ServiceFabricDeployedApplication názvy adresářů v adresáři WorkDirectory, LogDirectory a TempDirectory. Při stahování nasazeného objektuApplicationStatus mají hodnoty WorkDirectory, LogDirectory a TempDirectory hodnotu null.

Nasazené aplikační služby ukládají uložená trvalá data v Pracovním adresáři. Pro účely ladění nebo diagnostiky může být potřeba znát umístění pracovního adresáře jiné aplikace nebo procesu.

Nasazené aplikační služby by měly ukládat své protokoly do adresáře LogDirectory vytvořeného Service Fabric. Vlastní nahrání souborů protokolu může potřebovat znát umístění. Umístění LogDirectory může být potřeba i pro diagnostické účely, pokud aplikace na konkrétním uzlu nefunguje podle očekávání.

Ve výchozím nastavení tento dotaz vrátí počet výsledků omezených na konfiguraci maximální velikosti zprávy. Sady SDK a clustery verze 6.1 nebo novější podporují funkce stránkování, které toto omezení odeberou; Nové chování bude vrátit výsledky bez ohledu na maximální velikost zprávy konfigurace, protože tento dotaz prochází všechny vrácené stránky transparentně. Pokud chcete použít stránkování a další nové funkce, přečtěte si sadu parametrů UsePagedAPI. Výběr všech nových filtrů signalizuje dotaz tak, aby používal stránkování pod kapotou. V opačném případě vyberte UsePaging a přihlaste se k dotazování na stránku.

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í aplikace 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

Tento příkaz vrátí nasazené aplikace. V tomto příkladu je nasazený objekt ApplicationStatus aktivní, a proto get-ServiceFabricDeployedApplication vrátí názvy adresářů v návratových hodnotách WorkDirectory, LogDirectory a TempDirectory .

Příklad 2: Získání aplikace fabric:/samples/VQueueApp2

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

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

Tento příkaz vrátí nasazené aplikace. V tomto příkladu je DeployedApplicationStatus stahována, a proto příkaz vrátí hodnoty null pro WorkDirectory, LogDirectory a TempDirectory.

Příklad 3: Získání aplikací s maximálními výsledky

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

Tento příkaz získá všechny aplikace Service Fabric nasazené na poskytnutém uzlu v clusteru, který se vejde na stránku. Velikost stránky je dále omezena na dvě položky, jak je nakonfigurováno parametrem MaxResults. Vzhledem k tomu, že jsme vybrali možnost GetSinglePage, vrátí tento dotaz pouze jednu stránku výsledků. MaxResults nelze použít bez této možnosti. Výběrem možnosti "Podrobné" se vytiskne vrácená hodnota tokenu pokračování. Tuto hodnotu lze použít v dalším dotazu k získání další stránky výsledků. Vrácený token pokračování můžete získat také tak, že uložíte vrácené výsledky a získáte přístup k vlastnosti "ContinuationToken". Vlastnost "ContinuationToken" má hodnotu null, neexistuje žádný vrácený token pokračování.

Příklad 4: Získání aplikace s tokenem pokračování

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

Tento příkaz získá aplikace Service Fabric, které respektují zadaný token pro pokračování, který se vejde na jednu stránku. Token pro pokračování poskytnutý pro tento dotaz je stejný token vrácený z výše uvedeného příkladu. V tomto příkladu clusteru existuje pouze jedna položka, která respektuje token pokračování. Pokud existuje příliš mnoho aplikací, které respektují zadaný token pro pokračování v uzlu tak, aby se vešly do jedné stránky výsledků, tato konfigurace dotazu vrátí kompilaci všech vrácených stránek, prochází je transparentně; dotaz pak vrátí vektor všech výsledků. Pokud chcete získat pouze jednu stránku výsledků, vyberte možnost GetSinglePage.

Příklad 5: Získání aplikace se stavem

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

Tento příkaz získá aplikaci Service Fabric, která odpovídá zadanému názvu aplikace a obsahuje její stav.

Parametry

-ApplicationName

Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina získá nasazenou aplikaci, která odpovídá zadanému názvu aplikace. Tento dotaz přesně odpovídá. Například prostředky infrastruktury URI:/App nebudou odpovídat prostředkům infrastruktury:/App1. Pokud je zadaný název aplikace, vrátí se maximálně jeden výsledek. Pokud zadaný název aplikace neodpovídá žádné aplikaci na uzlu, vrátí dotaz hodnotu null.

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

-ContinuationToken

Určuje token pokračování, který lze použít k načtení další stránky výsledků dotazu.

Pokud je zadaných filtrů respektuje příliš mnoho výsledků, nemusí se vejít do jedné zprávy. Stránkování se používá k tomu rozdělením kolekce vrácených výsledků na samostatné stránky. Token pro pokračování slouží k tomu, aby věděl, kde předchozí stránka skončila, což má význam pouze pro samotný dotaz. Tato hodnota by se měla vygenerovat ze spuštění tohoto dotazu a lze ji předat do dalšího požadavku dotazu, aby bylo možné získat další stránky. Hodnota tokenu pokračování bez hodnoty null se vrátí jako součást výsledku pouze v případě, že je k dispozici další stránka. Pokud je tato hodnota zadaná bez možnosti -GetSinglePage, dotaz vrátí všechny stránky počínaje hodnotou tokenu pokračování.

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

-GetSinglePage

Určuje, zda dotaz vrátí jednu stránku výsledků dotazu s hodnotou tokenu pokračování nebo všechny stránky sloučené do jednoho seznamu výsledků. Pokud je tato možnost vybraná, je zodpovědná za volajícího dotazu, aby zkontroloval další stránky.

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

-IncludeHealthState

Určuje, jestli dotaz vrátí stav nasazených aplikací. Pokud tento parametr není zadaný, vrátí se stav Neznámý. Po výběru se dotaz paralelně připojí k uzlu a službě health system service před sloučením výsledků. V důsledku toho je dotaz dražší a může trvat delší dobu.

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

-MaxResults

Určuje maximální počet výsledků položek, které lze vrátit na stránku. Tím se definuje horní mez počtu vrácených výsledků, nikoli minimálně. Pokud například stránka odpovídá maximálně 1000 vrácených položek podle maximálního omezení velikosti zprávy definované v konfiguraci a hodnota MaxResults je nastavena na 2000, vrátí se pouze 1 000 výsledků, a to i v případě, že 2000 položek výsledků odpovídá popisu dotazu.

Tato hodnota vyžaduje výběr příznaku GetSinglePage; Jinak se bude ignorovat.

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

-NodeName

Určuje název uzlu Service Fabric. Rutina získá aplikace nasazené na zadaný uzel.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
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, zda bude dotaz stránkován. Pokud tento dotaz není vybraný, nebude tento dotaz fungovat, pokud se na jednu stránku nevejde příliš mnoho výsledků, jak je definováno konfigurací maximální velikosti zprávy. Výběrem této možnosti se tento dotaz nakonfiguruje tak, aby vracel všechny výsledky bez ohledu na konfiguraci maximální velikosti zprávy. Dělá to tak, že dostanete stránkované výsledky a projdete všechny stránky transparentně jménem volajícího.

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

System.Uri

Výstupy

System.Object