Delen via

Get-ServiceFabricDeployedApplication

  • Referentie
Module:
ServiceFabric

Hiermee haalt u de Service Fabric-toepassing(en) op een opgegeven knooppunt op.

Syntax

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

De cmdlet Get-ServiceFabricDeployedApplication haalt de Service Fabric-toepassing (en) op die zijn geïmplementeerd op een opgegeven knooppunt.

Service Fabric maakt werk-, logboek- en tijdelijke mappen op het knooppunt voor elke geïmplementeerde toepassing. Omdat de mapnamen de toepassings-id bevatten, kunnen de mapnamen niet worden geraden. Wanneer de DeployedApplicationStatus Actief is, retourneert Get-ServiceFabricDeployedApplication de mapnamen in de retourwaarden WorkDirectory, LogDirectory en TempDirectory . Wanneer de DeployedApplicationStatus wordt gedownload, zijn de waarden WorkDirectory, LogDirectory en TempDirectory null.

De geïmplementeerde toepassingsservices slaan hun persistente gegevens op in de WorkDirectory. Voor foutopsporing of diagnostische doeleinden moet een andere toepassing of een ander proces mogelijk de locatie van de WorkDirectory kennen.

De geïmplementeerde toepassingsservices moeten hun logboek opslaan in de LogDirectory die is gemaakt door Service Fabric. Een aangepaste uploader van de logboekbestanden moet mogelijk de locatie kennen. De locatie van de LogDirectory kan ook nodig zijn voor diagnostische doeleinden als een toepassing op een bepaald knooppunt niet werkt zoals verwacht.

Deze query retourneert standaard een aantal resultaten die beperkt zijn tot de maximale berichtgrootteconfiguratie. SDK's en clusters versie 6.1 of hoger ondersteunen pagingfunctionaliteit waardoor deze beperking wordt verwijderd; het nieuwe gedrag is om de resultaten te retourneren, ongeacht de configuratie van de maximale berichtgrootte, omdat deze query op transparante wijze alle geretourneerde pagina's doorloopt. Zie de parameterset UsePagedAPI als u paging en andere nieuwe functies wilt gebruiken. Als u nieuwe filters voor de query selecteert om paginering onder de kap te gebruiken. Anders selecteert u UsePaging om u aan te vragen om query's op pagina's uit te voeren.

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: Toepassing 'fabric:/samples/CalcApp2' ophalen

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

Met deze opdracht worden geïmplementeerde toepassingen geretourneerd. In dit voorbeeld is de DeployedApplicationStatus Actief en retourneert Get-ServiceFabricDeployedApplication de mapnamen in de retourwaarden WorkDirectory, LogDirectory en TempDirectory .

Voorbeeld 2: toepassing 'fabric:/samples/VQueueApp2' ophalen

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

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

Met deze opdracht worden geïmplementeerde toepassingen geretourneerd. In dit voorbeeld wordt de DeployedApplicationStatus gedownload en retourneert de opdracht daarom waarden van null voor WorkDirectory, LogDirectory en TempDirectory.

Voorbeeld 3: Toepassing(en) ophalen met maximale resultaten

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

Met deze opdracht worden alle Service Fabric-toepassingen opgehaald die zijn geïmplementeerd op het opgegeven knooppunt in het cluster dat op een pagina past. De grootte van de pagina is verder beperkt tot twee items, zoals geconfigureerd door de parameter MaxResults. Omdat we de optie GetSinglePage hebben geselecteerd, retourneert deze query slechts één pagina met resultaten. MaxResults kan niet worden gebruikt zonder deze optie. Als u Uitgebreid selecteert, wordt de geretourneerde vervolgtokenwaarde afgedrukt. Deze waarde kan worden gebruikt in een volgende query om de volgende pagina met resultaten op te halen. U kunt ook toegang krijgen tot het geretourneerde vervolgtoken door de geretourneerde resultaten op te slaan en de eigenschap Vervolgtoken te openen. De eigenschap 'ContinuationToken' is null, omdat er geen geretourneerd vervolgtoken is.

Voorbeeld 4: Toepassing ophalen met vervolgtoken

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

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. In dit voorbeeldcluster is er slechts één item dat het vervolgtoken respecteert. Als er te veel toepassingen zijn die het opgegeven vervolgtoken op het knooppunt respecteren om in één pagina met resultaten te passen, retourneert deze queryconfiguratie een compilatie van alle geretourneerde pagina's, waarbij deze transparant worden doorlopen; de query retourneert vervolgens een vector van alle resultaten. Als u slechts één pagina met resultaten wilt ophalen, selecteert u de optie GetSinglePage.

Voorbeeld 5: Toepassing ophalen met status

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

Met deze opdracht wordt de Service Fabric-toepassing opgehaald die overeenkomt met de opgegeven toepassingsnaam en de status ervan bevat.

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. De cmdlet haalt de geïmplementeerde toepassing op die overeenkomt met de opgegeven toepassingsnaam. Deze query doet een exacte overeenkomst. De URI-infrastructuur:/App komt bijvoorbeeld niet overeen met fabric:/App1. Er wordt maximaal één resultaat geretourneerd als de naam van de toepassing wordt opgegeven. Als de opgegeven toepassingsnaam niet overeenkomt met een toepassing op het knooppunt, retourneert de query null.

Type:Uri
Position:1
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

-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:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeHealthState

Hiermee geeft u op of de query de status van geïmplementeerde toepassingen retourneert. Als deze parameter niet is opgegeven, is de geretourneerde status Onbekend. Wanneer deze optie is geselecteerd, wordt de query parallel met het knooppunt en de statussysteemservice uitgevoerd voordat de resultaten worden samengevoegd. Als gevolg hiervan is de query duurder en kan het langer duren.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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

-NodeName

Hiermee geeft u de naam van een Service Fabric-knooppunt. De cmdlet haalt toepassingen op die zijn geïmplementeerd op het knooppunt dat u opgeeft.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-UsePaging

Hiermee geeft u op of de query wordt gepaginad. Als deze query niet is geselecteerd, werkt deze query niet wanneer er te veel resultaten zijn om op één pagina te passen, zoals gedefinieerd door de configuratie van de maximale berichtgrootte. Als u deze optie selecteert, configureert u deze query om alle resultaten te retourneren, ongeacht de configuratie van de maximale berichtgrootte. Dit doet u door gepaginade resultaten op te halen en alle pagina's transparant te doorlopen namens de beller.

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

Invoerwaarden

System.String

System.Uri

Uitvoerwaarden

System.Object