Get-ServiceFabricApplication
Haalt de toepassing(en) op in het Service Fabric-cluster.
Syntax
AllPages (Standaard)
Get-ServiceFabricApplication
[[-ApplicationName] <Uri>]
[-ApplicationTypeName <String>]
[-ExcludeApplicationParameters]
[-ContinuationToken <String>]
[-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
SinglePage
Get-ServiceFabricApplication
[[-ApplicationName] <Uri>]
[-ApplicationTypeName <String>]
[-ExcludeApplicationParameters]
[-GetSinglePage]
[-ContinuationToken <String>]
[-MaxResults <Int64>]
[-ApplicationDefinitionKindFilter <ApplicationDefinitionKindFilter>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
De Get-ServiceFabricApplication cmdlet 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, is het standaardgedrag van deze query, in tegenstelling tot de REST- of C#-equivalente aanroepen, het standaardgedrag van deze query om alle geretourneerde pagina's transparant te doorlopen. Met de optie GetSinglePage wordt deze query geconfigureerd 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 op naam ophalen
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-toepassing(en) 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 als het resultaat uit het bovenstaande voorbeeld. De optie Uitgebreid toont geen vervolgtoken, waarbij wordt aangegeven dat er geen pagina's meer beschikbaar zijn.
Voorbeeld 7: Toepassing ophalen op naam terwijl toepassingsparameters worden uitgesloten
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. Ten hoogste één van ApplicationName, ApplicationTypeName of ApplicationDefinitionKindFilter kan worden opgegeven. Als er geen filter is opgegeven, worden alle toepassingen geretourneerd.
Parametereigenschappen
| Type: | ApplicationDefinitionKindFilter |
| Default value: | None |
| Geaccepteerde waarden: | Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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. Ten hoogste één van ApplicationName, ApplicationTypeName of ApplicationDefinitionKindFilter kan worden opgegeven. Als er geen filter is opgegeven, worden alle toepassingen geretourneerd.
Parametereigenschappen
| Type: | Uri |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | 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. Ten hoogste één van ApplicationName, ApplicationTypeName of ApplicationDefinitionKindFilter kan worden opgegeven. Als er geen filter is opgegeven, worden alle toepassingen geretourneerd.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | 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 mee 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, waarbij alleen de query zelf significant is. 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 als onderdeel van het resultaat geretourneerd als er een volgende pagina is. Als deze waarde wordt opgegeven zonder de optie -GetSinglePage, retourneert de query alle pagina's vanaf de vervolgtokenwaarde.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ExcludeApplicationParameters
Hiermee geeft u op of toepassingsparameters worden uitgesloten van het resultaat.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-GetSinglePage
Hiermee geeft u op of de query één pagina met queryresultaten met een vervolgtokenwaarde retourneert, of alle pagina's gecombineerd tot één lijst met resultaten. Als deze optie is geselecteerd, is dit de verantwoordelijkheid van de aanroeper van de query om te controleren op volgende pagina's.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SinglePage
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 op basis van de maximale berichtgroottebeperkingen 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.
Parametereigenschappen
| Type: | Int64 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
SinglePage
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-TimeoutSec
Hiermee geeft u de time-outperiode, in seconden, voor de bewerking.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.