Get-ServiceFabricApplication

  • Reference
Modul:
ServiceFabric

Získá aplikace v clusteru Service Fabric.

Syntax

Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-ContinuationToken <String>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplication
   [[-ApplicationName] <Uri>]
   [-ApplicationTypeName <String>]
   [-ExcludeApplicationParameters]
   [-GetSinglePage]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Rutina Get-ServiceFabricApplication získá aplikace v clusteru Service Fabric. Ve výchozím nastavení neexistují žádná omezení počtu výsledků dotazu, které může tento dotaz vrátit bez ohledu na konfiguraci maximální velikosti zprávy; i když se jedná o stránkovaný dotaz, na rozdíl od ekvivalentních volání REST nebo C#, výchozím chováním tohoto dotazu je projít všechny vrácené stránky transparentně. Možnost GetSinglePage nakonfiguruje tento dotaz tak, aby vrátil jednu 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í všech aplikací

PS C:\> Get-ServiceFabricApplication

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : { "ServiceInstanceCount" = "4" }

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

Tento příkaz získá všechny aplikace v clusteru.

Příklad 2: Získání aplikace podle názvu

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/samples/PQueueApp1

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

Tento příkaz získá konkrétní aplikaci s názvem fabric:/samples/PQueueApp1.

Příklad 3: Získání aplikace podle názvu typu

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

Tento příkaz získá aplikace Service Fabric, jejichž název typu je PersistentQueueApp.

Příklad 4: Získání aplikace podle typu definice

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

Tento příkaz získá aplikace Service Fabric, které jsou definované popisem aplikace Service Fabric.

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

PS C:\>Get-ServiceFabricApplication -MaxResults 2 -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/CalculatorApp
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : "ServiceInstanceCount" = "4"
                            

VERBOSE: Continuation Token: fabric:/samples/CalculatorAppWithAppParameters

Tento příkaz získá všechny aplikace Service Fabric v clusteru, které se vejdou na stránku. Zatímco v clusteru existuje více aplikací, vrátí se podle konfigurace parametru MaxResults pouze dva výsledky. Vzhledem k tomu, že se výsledky nevejdou na stránku, vrátí se hodnota tokenu pokračování označující přítomnost dalších stránek.

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

PS C:\>Get-ServiceFabricApplication -ContinuationToken fabric:/samples/CalculatorAppWithAppParameters -GetSinglePage -Verbose

ApplicationName           : fabric:/samples/PQueueApp1
ApplicationTypeName       : PersistentQueueApp
ApplicationTypeVersion    : 1.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

ApplicationName           : fabric:/VQueueApp1
ApplicationTypeName       : Compose_0
ApplicationTypeVersion    : v0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : Compose
ApplicationParameters     : {}

VERBOSE: Continuation Token:

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. Možnost Podrobné zobrazení neobsahuje token pokračování, který označuje, že nejsou k dispozici žádné další stránky.

Příklad 7: Získání aplikace podle názvu při vyloučení parametrů aplikace

PS C:\>Get-ServiceFabricApplication -ApplicationName fabric:/samples/CalculatorAppWithAppParameters -ExcludeApplicationParameters

ApplicationName           : fabric:/samples/CalculatorAppWithAppParameters
ApplicationTypeName       : CalculatorApp
ApplicationTypeVersion    : 2.0
ApplicationStatus         : Ready
HealthState               : Ok
ApplicationDefinitionKind : ServiceFabricApplicationDescription
ApplicationParameters     : {}

Tento příkaz získá aplikaci Service Fabric, která odpovídá zadanému názvu aplikace. Jak je vidět v příkladu 5, tato aplikace má parametry aplikace, ale je vyloučena z vrácených výsledků kvůli příznaku ExcludeApplicationParameters.

Parametry

-ApplicationDefinitionKindFilter

Určuje filtr pro ApplicationDefinitionKindFilter na základě způsobu definování aplikace. Hodnotu lze získat ze členů nebo bitové operace u členů ApplicationDefinitionKindFilter. Vrátí se jenom aplikace, které odpovídají filtru. Je možné zadat maximálně jeden z ApplicationName, ApplicationTypeName nebo ApplicationDefinitionKindFilter. Pokud není zadaný žádný filtr, vrátí se všechny aplikace.

Type:ApplicationDefinitionKindFilter
Accepted values:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationName

Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina získá aplikaci, která má zadaný identifikátor URI. Je možné zadat maximálně jeden z ApplicationName, ApplicationTypeName nebo ApplicationDefinitionKindFilter. Pokud není zadaný žádný filtr, vrátí se všechny aplikace.

Type:Uri
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationTypeName

Určuje název typu aplikace, který se používá k filtrování aplikací pro dotazování. Je možné zadat maximálně jeden z ApplicationName, ApplicationTypeName nebo ApplicationDefinitionKindFilter. Pokud není zadaný žádný filtr, vrátí se všechny aplikace.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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í.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeApplicationParameters

Určuje, zda budou parametry aplikace vyloučeny z výsledku.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

System.Uri

System.String

Výstupy

System.Object