Get-ServiceFabricApplication

  • Referentie
Module:
ServiceFabric

Haalt de toepassing(en) op in het Service Fabric-cluster.

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

De cmdlet Get-ServiceFabricApplication haalt de toepassing(en) op in het Service Fabric-cluster. Standaard zijn er geen beperkingen voor het aantal queryresultaten dat door deze query kan worden geretourneerd, ongeacht de configuratie van de maximale berichtgrootte; Hoewel dit een paginaquery is, in tegenstelling tot de rest- of C#-equivalente aanroepen, is het standaardgedrag van deze query om alle geretourneerde pagina's transparant te doorlopen. Met de optie GetSinglePage configureert u deze query om één pagina te retourneren.

Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .

Voorbeelden

Voorbeeld 1: Alle toepassingen ophalen

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     : {}

Met deze opdracht worden alle toepassingen in het cluster opgehaald.

Voorbeeld 2: Toepassing ophalen op naam

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

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

Met deze opdracht wordt de specifieke toepassing opgehaald met de naam fabric:/samples/PQueueApp1.

Voorbeeld 3: Toepassing ophalen op typenaam

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

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

Met deze opdracht worden de Service Fabric-toepassingen opgehaald waarvan de typenaam PersistentQueueApp is.

Voorbeeld 4: Toepassing op definitietype ophalen

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

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

Met deze opdracht worden de Service Fabric-toepassingen opgehaald die zijn gedefinieerd door de beschrijving van de Service Fabric-toepassing.

Voorbeeld 5: Toepassing ophalen met maximale resultaten

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

Met deze opdracht worden alle Service Fabric-toepassingen in het cluster opgehaald die op een pagina passen. Hoewel er meer toepassingen in het cluster zijn, worden er slechts twee resultaten geretourneerd zoals geconfigureerd door de parameter MaxResults. Omdat er resultaten zijn die niet op de pagina passen, wordt een vervolgtokenwaarde geretourneerd die de aanwezigheid van volgende pagina's aangeeft.

Voorbeeld 6: Toepassing ophalen met vervolgtoken

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:

Met deze opdracht worden de Service Fabric-toepassingen opgehaald die het opgegeven vervolgtoken respecteren dat in één pagina past. Het vervolgtoken dat aan deze query is verstrekt, is dezelfde die wordt geretourneerd uit het bovenstaande voorbeeld. De optie Uitgebreid toont geen vervolgtoken, waarbij wordt aangegeven dat er geen pagina's meer beschikbaar zijn.

Voorbeeld 7: Toepassing op naam ophalen tijdens het uitsluiten van toepassingsparameters

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     : {}

Met deze opdracht wordt de Service Fabric-toepassing opgehaald die overeenkomt met de opgegeven toepassingsnaam. Zoals u ziet in voorbeeld 5, heeft deze toepassing toepassingsparameters, maar wordt uitgesloten van de geretourneerde resultaten vanwege de vlag ExcludeApplicationParameters

Parameters

-ApplicationDefinitionKindFilter

Hiermee geeft u het filter voor ApplicationDefinitionKindFilter op basis van hoe de toepassing wordt gedefinieerd. De waarde kan worden verkregen van leden of bitwise bewerkingen op leden van ApplicationDefinitionKindFilter. Alleen toepassingen die overeenkomen met het filter worden geretourneerd. Maximaal één van ApplicationName, ApplicationTypeName of ApplicationDefinitionKindFilter kan worden opgegeven. Als er geen filter is opgegeven, worden alle toepassingen geretourneerd.

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

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. De cmdlet haalt de toepassing op met de opgegeven URI. Maximaal één van ApplicationName, ApplicationTypeName of ApplicationDefinitionKindFilter kan worden opgegeven. Als er geen filter is opgegeven, worden alle toepassingen geretourneerd.

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

-ApplicationTypeName

Hiermee geeft u de naam van het toepassingstype op die wordt gebruikt om de toepassingen te filteren waarvoor een query moet worden uitgevoerd. Maximaal één van ApplicationName, ApplicationTypeName of ApplicationDefinitionKindFilter kan worden opgegeven. Als er geen filter is opgegeven, worden alle toepassingen geretourneerd.

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

-ContinuationToken

Hiermee geeft u het vervolgtoken op dat kan worden gebruikt om de volgende pagina met queryresultaten op te halen.

Als te veel resultaten de opgegeven filters respecteren, passen ze mogelijk niet in één bericht. Paging wordt gebruikt om hiervoor rekening te houden door de verzameling geretourneerde resultaten op te splitsen in afzonderlijke pagina's. Het vervolgtoken wordt gebruikt om te weten waar de vorige pagina is gebleven, wat alleen significantie aan de query zelf heeft. Deze waarde moet worden gegenereerd door deze query uit te voeren en kan worden doorgegeven aan de volgende queryaanvraag om volgende pagina's op te halen. Een niet-null-vervolgtokenwaarde wordt alleen geretourneerd als onderdeel van het resultaat als er een volgende pagina is. Als deze waarde wordt opgegeven zonder de optie -GetSinglePage, retourneert de query alle pagina's die beginnen met de vervolgtokenwaarde.

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

-ExcludeApplicationParameters

Hiermee geeft u op of toepassingsparameters worden uitgesloten van het resultaat.

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

-GetSinglePage

Hiermee geeft u op of de query één pagina met queryresultaten retourneert met een vervolgtokenwaarde, of alle pagina's gecombineerd tot één lijst met resultaten. Als deze optie is geselecteerd, is het de verantwoordelijkheid van de aanroeper van de query om te controleren op volgende pagina's.

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

-MaxResults

Hiermee geeft u het maximum aantal resultaatitems op dat per pagina kan worden geretourneerd. Hiermee definieert u de bovengrens voor het aantal geretourneerde resultaten, niet een minimum. Als de pagina bijvoorbeeld maximaal 1000 geretourneerde items past volgens de beperkingen voor maximale berichtgrootte die zijn gedefinieerd in de configuratie en de waarde MaxResults is ingesteld op 2000, worden er slechts 1000 resultaten geretourneerd, zelfs als 2000 resultaatitems overeenkomen met de querybeschrijving. Deze waarde vereist selectie van de getSinglePage-vlag; Anders wordt het genegeerd.

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

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.

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

Invoerwaarden

System.Uri

System.String

Uitvoerwaarden

System.Object