Dela via

Get-ServiceFabricDeployedApplication

  • Referens
Modul:
ServiceFabric

Hämtar Service Fabric-program på en angiven nod.

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

Cmdleten Get-ServiceFabricDeployedApplication hämtar Service Fabric-program som distribuerats på en angiven nod.

Service Fabric skapar arbets-, logg- och tillfälliga kataloger på noden för varje distribuerat program. Eftersom katalognamnen innehåller program-ID:t kan katalognamnen inte gissas. När DeployedApplicationStatus är Aktiv returnerar Get-ServiceFabricDeployedApplication katalognamnen i returvärdena WorkDirectory, LogDirectory och TempDirectory . När Värdena DeployedApplicationStatus laddas ned är värdena WorkDirectory, LogDirectory och TempDirectory null.

De distribuerade programtjänsterna lagrar sina sparade data i WorkDirectory. För felsökning eller diagnostik kan ett annat program eller en annan process behöva känna till platsen för WorkDirectory.

De distribuerade programtjänsterna bör lagra sin logg i LogDirectory som skapats av Service Fabric. En anpassad uppladdare av loggfilerna kan behöva känna till platsen. LogDirectorys plats kan också behövas för diagnostiska ändamål när ett program på en viss nod inte fungerar som förväntat.

Som standard returnerar den här frågan ett antal resultat som är begränsade till den maximala meddelandestorlekskonfigurationen. SDK:er och klusterversioner 6.1 eller senare stöder växlingsfunktioner som tar bort den här begränsningen. Det nya beteendet blir att returnera resultaten oavsett maximal konfiguration av meddelandestorlek eftersom frågan loopar igenom alla returnerade sidor transparent. Information om hur du använder växling och andra nya funktioner finns i parameteruppsättningen "UsePagedAPI". Val av nya filter signalerar till frågan att använda växling under huven. Annars väljer du "UsePaging" för att välja sidfråga.

Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .

Exempel

Exempel 1: Hämta programmet "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

Det här kommandot returnerar distribuerade program. I det här exemplet är DeployedApplicationStatus Aktiv och därför returnerar Get-ServiceFabricDeployedApplication katalognamnen i returvärdena WorkDirectory, LogDirectory och TempDirectory .

Exempel 2: Hämta programmet "fabric:/samples/VQueueApp2"

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

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

Det här kommandot returnerar distribuerade program. I det här exemplet laddas DeployedApplicationStatus ned och därför returnerar kommandot värden för null för WorkDirectory, LogDirectory och TempDirectory.

Exempel 3: Hämta program med maximalt resultat

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

Det här kommandot hämtar alla Service Fabric-program som distribueras på den angivna noden i klustret som får plats på en sida. Sidans storlek är ytterligare begränsad till två objekt, vilket konfigureras av parametern MaxResults. Eftersom vi valde alternativet "GetSinglePage" returnerar den här frågan bara en sida med resultat. MaxResults kan inte användas utan det här alternativet. Om du väljer "Utförlig" skrivs det returnerade fortsättningstokenvärdet ut. Det här värdet kan användas i en efterföljande fråga för att hämta nästa resultatsida. Du kan också komma åt den returnerade fortsättningstoken genom att spara de returnerade resultaten och komma åt egenskapen "ContinuationToken". Egenskapen "ContinuationToken" är null om det inte finns någon returnerad fortsättningstoken.

Exempel 4: Hämta program med fortsättningstoken

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

Det här kommandot hämtar Service Fabric-program som respekterar den angivna fortsättningstoken som får plats på en enda sida. Fortsättningstoken som tillhandahålls till den här frågan är samma som returneras från exemplet ovan. I det här exempelklustret finns det bara ett objekt som respekterar fortsättningstoken. Om det finns för många program som respekterar den angivna fortsättningstoken på noden för att passa in på en sida med resultat returnerar den här frågekonfigurationen en kompilering av alla returnerade sidor och loopar igenom dem transparent. frågan returnerar sedan en vektor för alla resultat. Om du bara vill få en sida med resultat väljer du alternativet "GetSinglePage".

Exempel 5: Hämta program med hälsotillstånd

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

Det här kommandot hämtar Service Fabric-programmet som matchar det angivna programnamnet och innehåller dess hälsotillstånd.

Parametrar

-ApplicationName

Anger URI (Uniform Resource Identifier) för ett Service Fabric-program. Cmdleten hämtar det distribuerade programmet som matchar det angivna programnamnet. Den här frågan matchar exakt. Till exempel matchar URI-infrastrukturresurserna:/Appen inte infrastrukturresurser:/App1. Högst ett resultat returneras om programnamnet anges. Om det angivna programnamnet inte matchar något program på noden returnerar frågan null.

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

-ContinuationToken

Anger fortsättningstoken som kan användas för att hämta nästa sida med frågeresultat.

Om för många resultat respekterar de angivna filtren kanske de inte får plats i ett meddelande. Växling används för att ta hänsyn till detta genom att dela upp samlingen av returnerade resultat i separata sidor. Fortsättningstoken används för att veta var föregående sida slutade, vilket endast medför signifikans för själva frågan. Det här värdet ska genereras från att köra den här frågan och kan skickas till nästa frågebegäran för att hämta efterföljande sidor. Ett fortsättningstokenvärde som inte är null returneras som en del av resultatet endast om det finns en efterföljande sida. Om det här värdet anges utan alternativet -GetSinglePage returnerar frågan alla sidor från fortsättningstokenvärdet.

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

-GetSinglePage

Anger om frågan ska returnera en sida med frågeresultat med ett fortsättningstokenvärde eller alla sidor som kombineras i en lista med resultat. Om det här alternativet är markerat är det uppringarens ansvar att söka efter efterföljande sidor.

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

-IncludeHealthState

Anger om frågan ska returnera hälsotillståndet för distribuerade program. Om den här parametern inte har angetts är hälsotillståndet som returneras "Okänt". När frågan väljs går den parallellt med noden och hälsosystemtjänsten innan resultaten slås samman. Därför är frågan dyrare och kan ta längre tid.

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

-MaxResults

Anger det maximala antalet resultatobjekt som kan returneras per sida. Detta definierar den övre gränsen för det antal resultat som returneras, inte ett minimum. Om sidan till exempel passar högst 1 000 returnerade objekt enligt maximala begränsningar för meddelandestorlek som definierats i konfigurationen och maxResults-värdet är inställt på 2 000 returneras endast 1 000 resultat, även om 2 000 resultatobjekt matchar frågebeskrivningen.

Det här värdet kräver val av flaggan GetSinglePage. annars ignoreras den.

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

-NodeName

Anger namnet på en Service Fabric-nod. Cmdleten hämtar program som distribueras på den nod som du anger.

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

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

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

-UsePaging

Anger om frågan ska sökas. Om den här frågan inte är markerad fungerar den inte när det finns för många resultat för att få plats på en sida, vilket definieras av konfigurationen för maximal meddelandestorlek. Om du väljer det här alternativet konfigureras den här frågan så att alla resultat returneras, oavsett den maximala meddelandestorlekskonfigurationen. Det gör det genom att hämta sidiga resultat och loopa igenom alla sidor transparent för anroparens räkning.

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

Indata

System.String

System.Uri

Utdata

System.Object