Get-ServiceFabricApplication

  • Referens
Modul:
ServiceFabric

Hämtar program i Service Fabric-klustret.

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

Cmdleten Get-ServiceFabricApplication hämtar programmen i Service Fabric-klustret. Som standard finns det inga begränsningar för antalet frågeresultat som kan returneras av den här frågan, oavsett konfigurationen av maximal meddelandestorlek. Även om det här är en växlingsfråga, till skillnad från REST- eller C#-motsvarande anrop, är standardbeteendet för den här frågan att loopa igenom alla returnerade sidor transparent. Alternativet GetSinglePage konfigurerar den här frågan så att den returnerar en enda sida.

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 alla program

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

Det här kommandot hämtar alla program i klustret.

Exempel 2: Hämta programmet efter namn

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

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

Det här kommandot hämtar det specifika programmet med namnet fabric:/samples/PQueueApp1.

Exempel 3: Hämta programmet efter typnamn

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

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

Det här kommandot hämtar Service Fabric-program vars typnamn är PersistentQueueApp.

Exempel 4: Hämta program per definition

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

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

Det här kommandot hämtar Service Fabric-program som definieras av Beskrivning av Service Fabric-programmet.

Exempel 5: Hämta program med maximalt resultat

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

Det här kommandot hämtar alla Service Fabric-program i klustret som får plats på en sida. Även om det finns fler program i klustret returneras endast två resultat som konfigurerats av parametern MaxResults. Eftersom det finns resultat som inte får plats på sidan returneras ett fortsättningstokenvärde som anger förekomsten av efterföljande sidor.

Exempel 6: Hämta program med fortsättningstoken

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:

Det här kommandot hämtar Service Fabric-program som respekterar den angivna fortsättningstoken som passar in på en enda sida. Fortsättningstoken som tillhandahålls till den här frågan är samma som returneras från exemplet ovan. Alternativet "Utförlig" visar ingen fortsättningstoken som symboliserar att inga fler sidor är tillgängliga.

Exempel 7: Hämta programmet efter namn samtidigt som programparametrar exkluderas

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

Det här kommandot hämtar Service Fabric-programmet som matchar det angivna programnamnet. Som vi ser i exempel 5 har det här programmet programparametrar, men exkluderas från de returnerade resultaten på grund av flaggan "ExcludeApplicationParameters"

Parametrar

-ApplicationDefinitionKindFilter

Anger filtret för ApplicationDefinitionKindFilter baserat på hur programmet definieras. Värdet kan hämtas från medlemmar eller bitvis åtgärder på medlemmar i ApplicationDefinitionKindFilter. Endast program som matchar filtret returneras. Högst ett av ApplicationName, ApplicationTypeName eller ApplicationDefinitionKindFilter kan anges. Om inget filter anges returneras alla program.

Typ:ApplicationDefinitionKindFilter
Godkända värden:Default, ServiceFabricApplicationDescription, Compose, MeshApplicationDescription, All
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationName

Anger URI (Uniform Resource Identifier) för ett Service Fabric-program. Cmdleten hämtar det program som har den angivna URI:n. Högst ett av ApplicationName, ApplicationTypeName eller ApplicationDefinitionKindFilter kan anges. Om inget filter anges returneras alla program.

Typ:Uri
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ApplicationTypeName

Anger namnet på programtypen som används för att filtrera de program som ska frågas efter. Högst ett av ApplicationName, ApplicationTypeName eller ApplicationDefinitionKindFilter kan anges. Om inget filter anges returneras alla program.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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 passar in i ett meddelande. Växling används för att ta hänsyn till detta genom att dela upp samlingen med returnerade resultat i separata sidor. Fortsättningstoken används för att veta var föregående sida slutade, med endast betydelse 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 med början från fortsättningstokenvärdet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExcludeApplicationParameters

Anger om programparametrar ska undantas från resultatet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GetSinglePage

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken: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å 2000, 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 det.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

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

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

System.Uri

System.String

Utdata

System.Object