Share via

Get-ServiceFabricApplication

  • Referencia
Modul:
ServiceFabric

Lekéri az alkalmazás(oka)t a Service Fabric-fürtön.

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

A Get-ServiceFabricApplication parancsmag lekéri az alkalmazás(oka)t a Service Fabric-fürtön. Alapértelmezés szerint a lekérdezés által visszaadható lekérdezési eredmények száma nincs korlátozva, függetlenül az üzenet maximális méretének konfigurációtól; Bár ez egy lapozott lekérdezés, a REST- vagy C#-egyenértékű hívásokkal ellentétben a lekérdezés alapértelmezett viselkedése az, hogy az összes visszaadott oldalt transzparensen végighaladja. A GetSinglePage beállítás úgy konfigurálja ezt a lekérdezést, hogy egyetlen oldalt adjon vissza.

Mielőtt bármilyen műveletet végrehajt egy Service Fabric-fürtön, hozzon létre kapcsolatot a fürttel a Connect-ServiceFabricCluster parancsmag használatával.

Példák

1. példa: Az összes alkalmazás lekérése

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

Ez a parancs lekéri a fürt összes alkalmazását.

2. példa: Alkalmazás lekérése név alapján

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

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

Ez a parancs lekéri az adott alkalmazást a névhálóval:/samples/PQueueApp1.

3. példa: Alkalmazás lekérése típusnév alapján

PS C:\>Get-ServiceFabricApplication -ApplicationTypeName PersistentQueueApp

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

Ez a parancs lekéri azokat a Service Fabric-alkalmazás(oka)t, amelyeknek a típusneve PersistentQueueApp.

4. példa: Alkalmazás lekérése definíciótípus szerint

PS C:\>Get-ServiceFabricApplication -ApplicationDefinitionKindFilter Compose

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

Ez a parancs lekéri a Service Fabric-alkalmazás(ok)t, amelyeket a Service Fabric-alkalmazás leírása határoz meg.

5. példa: Alkalmazás lekérése maximális eredménnyel

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

Ez a parancs lekéri a fürtben lévő összes Service Fabric-alkalmazást, amely elfér egy lapra. Bár a fürtben több alkalmazás található, csak két eredményt ad vissza a MaxResults paraméter által konfigurált módon. Mivel vannak olyan eredmények, amelyek nem férnek el az oldalra, a rendszer egy folytatási jogkivonat-értéket ad vissza, amely a későbbi lapok jelenlétét jelzi.

6. példa: Alkalmazás lekérése folytatási jogkivonattal

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:

Ez a parancs lekéri a Service Fabric-alkalmazás(oka)t, amely figyelembe veszi a megadott folytatási jogkivonatot, amely egyetlen oldalra illeszkedik. A lekérdezéshez megadott folytatási jogkivonat megegyezik a fenti példában visszaadott jogkivonattal. A Részletes beállítás nem jelenít meg folytatási jogkivonatot, ami azt jelzi, hogy nincs több oldal.

7. példa: Alkalmazás lekérése név alapján az alkalmazásparaméterek kizárása mellett

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

Ez a parancs lekéri a Megadott alkalmazásnévnek megfelelő Service Fabric-alkalmazást. Az 5. példában látható, hogy az alkalmazás rendelkezik alkalmazásparaméterekkel, de az "ExcludeApplicationParameters" jelző miatt ki van zárva a visszaadott eredmény(ek)ből

Paraméterek

-ApplicationDefinitionKindFilter

Az ApplicationDefinitionKindFilter szűrőjének megadása az alkalmazás definiálása alapján. Az érték az ApplicationDefinitionKindFilter tagjain végzett tagoktól vagy bitenkénti műveletektől kérhető le. A rendszer csak a szűrőnek megfelelő alkalmazásokat adja vissza. Az ApplicationName, Az ApplicationTypeName vagy az ApplicationDefinitionKindFilter típus közül legfeljebb egy adható meg. Ha nincs megadva szűrő, a rendszer minden alkalmazást visszaad.

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

Egy Service Fabric-alkalmazás egységes erőforrás-azonosítóját (URI) adja meg. A parancsmag lekéri a megadott URI-t tartalmazó alkalmazást. Az ApplicationName, Az ApplicationTypeName vagy az ApplicationDefinitionKindFilter típus közül legfeljebb egy adható meg. Ha nincs megadva szűrő, a rendszer minden alkalmazást visszaad.

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

-ApplicationTypeName

Megadja az alkalmazástípus nevét, amellyel szűrheti az alkalmazásokat a lekérdezéshez. Az ApplicationName, Az ApplicationTypeName vagy az ApplicationDefinitionKindFilter típus közül legfeljebb egy adható meg. Ha nincs megadva szűrő, a rendszer minden alkalmazást visszaad.

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

-ContinuationToken

Meghatározza a lekérdezési eredmények következő oldalának lekéréséhez használható folytatási jogkivonatot.

Ha túl sok eredmény tartja tiszteletben a megadott szűrőket, előfordulhat, hogy nem férnek bele egy üzenetbe. A lapozás ezt úgy veszi figyelembe, hogy a visszaadott eredmények gyűjteményét külön oldalakra osztja. A folytatási jogkivonat azt jelzi, hogy az előző oldal hol maradt hátra, és csak magára a lekérdezésre vonatkozik. Ezt az értéket a lekérdezés futtatásával kell létrehozni, és a következő lekérdezési kérelembe továbbítható a későbbi lapok lekéréséhez. A nem null értékű folytatási jogkivonat értéke csak akkor lesz visszaadva az eredmény részeként, ha van egy későbbi oldal. Ha ez az érték a -GetSinglePage beállítás nélkül van megadva, akkor a lekérdezés a folytatási jogkivonat értékétől kezdődő összes oldalt visszaadja.

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

-ExcludeApplicationParameters

Meghatározza, hogy az alkalmazásparaméterek ki lesznek-e zárva az eredményből.

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

-GetSinglePage

Azt adja meg, hogy a lekérdezés egy oldalnyi lekérdezési eredményt ad vissza egy folytatási jogkivonatértékkel, vagy az összes oldalt egyetlen találatlistába egyesíti. Ha ez a beállítás van kiválasztva, akkor a lekérdezés hívójának kell ellenőriznie a további oldalakat.

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

-MaxResults

Az oldalonként visszaadható eredményelemek maximális számát adja meg. Ez a visszaadott eredmények számának felső határát határozza meg, nem pedig a minimumot. Ha például a lap legfeljebb 1000 visszaadott elemet tartalmaz a konfigurációban meghatározott maximális üzenetméret-korlátozásoknak megfelelően, és a MaxResults érték 2000-re van állítva, akkor csak 1000 eredményt ad vissza, még akkor is, ha 2000 eredményelem felel meg a lekérdezés leírásának. Ehhez az értékhez ki kell választani a GetSinglePage jelzőt; ellenkező esetben a rendszer figyelmen kívül hagyja.

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

-TimeoutSec

A művelet időtúllépési időszakát adja meg másodpercben.

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

Bevitelek

System.Uri

System.String

Kimenetek

System.Object