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 program 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 den maximala meddelandestorlekskonfigurationen. Även om det här är en växlingsfråga, till skillnad från motsvarande REST- eller C#-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 en åtgärd på 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-program.

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 enligt konfigurationen 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 får plats på en enda sida. Den 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, vilket 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 bitvisa å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.

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

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.

Type:Uri
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
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. Sidindelning 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, med signifikans endast för själva frågan. Det här värdet ska genereras från körningen av 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

-ExcludeApplicationParameters

Anger om programparametrar ska undantas från resultatet.

Type:SwitchParameter
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 till en lista med resultat. Om det här alternativet väljs är det frågeanroparens ansvar att söka efter efterföljande sidor.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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 antalet returnerade resultat, inte ett minimum. Om sidan till exempel får högst 1 000 returnerade objekt enligt de maximala storleksbegränsningarna för meddelanden som definieras i konfigurationen och MaxResults-värdet anges till 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

-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

Indata

System.Uri

System.String

Utdata

System.Object