Megosztás a következőn keresztül:

Get-ServiceFabricDeployedApplication

  • Referencia
Modul:
ServiceFabric

Lekéri a Service Fabric-alkalmazás(oka)t egy megadott csomóponton.

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

A Get-ServiceFabricDeployedApplication parancsmag lekéri egy adott csomóponton üzembe helyezett Service Fabric-alkalmazás(ok)t.

A Service Fabric munka-, napló- és ideiglenes könyvtárakat hoz létre a csomóponton az egyes üzembe helyezett alkalmazásokhoz. Mivel a címtárnevek tartalmazzák az alkalmazásazonosítót, a címtárnevek nem találhatók ki. Ha az DeployedApplicationStatus aktív, a Get-ServiceFabricDeployedApplication visszaadja a WorkDirectory, LogDirectory és TempDirectory visszatérési értékek könyvtárneveit. Az DeployedApplicationStatus letöltésekor a WorkDirectory, LogDirectory és TempDirectory értékek null értékűek.

Az üzembe helyezett alkalmazásszolgáltatások a WorkDirectoryban tárolják a megőrzött adatokat. Hibakeresési vagy diagnosztikai célokból előfordulhat, hogy egy másik alkalmazásnak vagy folyamatnak ismernie kell a WorkDirectory helyét.

Az üzembe helyezett alkalmazásszolgáltatásoknak a naplójukat a Service Fabric által létrehozott LogDirectoryban kell tárolniuk. Előfordulhat, hogy a naplófájlok egyéni feltöltőjének tudnia kell a helyet. A LogDirectory helyére szükség lehet diagnosztikai célokra is, ha egy adott csomóponton lévő alkalmazás nem a várt módon működik.

Alapértelmezés szerint ez a lekérdezés az üzenet maximális méretkonfigurációjára korlátozott számú eredményt ad vissza. Az SDK-k és a fürtök 6.1-s vagy újabb verziói támogatják a lapozási funkciókat, amelyek megszüntetik ezt a korlátozást; az új viselkedés az lesz, hogy a maximális üzenetméret-konfigurációtól függetlenül visszaadja az eredményeket, mivel ez a lekérdezés transzparens módon végighalad az összes visszaadott oldalon. A lapozás és más új funkciók használatához tekintse meg a "UsePagedAPI" paraméterkészletet. A lekérdezés új szűrőjeleinek kiválasztása a motorháztető alatti lapozás használatához. Ellenkező esetben válassza a "UsePaging" lehetőséget a lapozott lekérdezések kiválasztásához.

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: "háló:/samples/CalcApp2" alkalmazás lekérése

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

Ez a parancs az üzembe helyezett alkalmazásokat adja vissza. Ebben a példában az DeployedApplicationStatus aktív, ezért a Get-ServiceFabricDeployedApplication visszaadja a WorkDirectory, a LogDirectory és a TempDirectory visszatérési értékeinek könyvtárneveit.

2. példa: "fabric:/samples/VQueueApp2" alkalmazás lekérése

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

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

Ez a parancs az üzembe helyezett alkalmazásokat adja vissza. Ebben a példában az DeployedApplicationStatus a Letöltés, ezért a parancs null értékeket ad vissza a WorkDirectory, a LogDirectory és a TempDirectory esetében.

3. példa: Alkalmazás(ok) lekérése maximális eredménnyel

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

Ez a parancs lekéri a fürt megadott csomópontján üzembe helyezett Service Fabric-alkalmazás(ok)t, amelyek egy lapra illeszkednek. Az oldal mérete további két elemre korlátozódik, a MaxResults paraméter által konfigurált módon. Mivel a "GetSinglePage" lehetőséget választottuk, ez a lekérdezés csak egy oldalnyi eredményt ad vissza. A MaxResults nem használható e lehetőség nélkül. A "Részletes" lehetőség kiválasztásával kinyomtatja a visszaadott folytatási jogkivonat értékét. Ez az érték egy későbbi lekérdezésben használható az eredmények következő oldalának lekéréséhez. A visszaadott folytatási jogkivonatot a visszaadott eredmények mentésével és a "ContinuationToken" tulajdonság elérésével is elérheti. A "ContinuationToken" tulajdonság null értékű, mert nincs visszaadott folytatási jogkivonat.

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

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

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. Ebben a példában a fürtben csak egy elem van, amely tiszteletben tartja a folytatási jogkivonatot. Ha túl sok alkalmazás tartja tiszteletben a megadott folytatási jogkivonatot a csomóponton ahhoz, hogy beleférjen az eredmények egy oldalába, akkor ez a lekérdezési konfiguráció az összes visszaadott oldal fordítását adja vissza, és transzparensen végighalad rajtuk; a lekérdezés ezután az összes eredmény vektorát adja vissza. Ha csak egy oldalnyi eredményt szeretne kapni, válassza a "GetSinglePage" lehetőséget.

5. példa: Alkalmazás lekérése állapottal

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

Ez a parancs lekéri a Service Fabric-alkalmazást, amely megfelel a megadott alkalmazásnévnek, és tartalmazza annak állapotát.

Paraméterek

-ApplicationName

Egy Service Fabric-alkalmazás egységes erőforrás-azonosítóját (URI) adja meg. A parancsmag lekéri a megadott alkalmazásnévnek megfelelő üzembe helyezett alkalmazást. Ez a lekérdezés pontosan egyezik. Például az URI-háló:/Az alkalmazás nem egyezik a hálóval:/App1. A rendszer legfeljebb egy eredményt ad vissza, ha az alkalmazás neve meg van adva. Ha a megadott alkalmazásnév nem egyezik a csomópont egyik alkalmazásával sem, a lekérdezés null értéket ad vissza.

Típus:Uri
Position:1
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-IncludeHealthState

Meghatározza, hogy a lekérdezés visszaadja-e az üzembe helyezett alkalmazások állapotát. Ha ez a paraméter nincs megadva, akkor a visszaadott állapot "Ismeretlen". Ha be van jelölve, a lekérdezés párhuzamosan halad a csomóponttal és az állapotrendszer-szolgáltatással az eredmények egyesítése előtt. Ennek eredményeképpen a lekérdezés drágább, és hosszabb időt vehet igénybe.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:Int64
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-NodeName

A Service Fabric-csomópont nevét adja meg. A parancsmag a megadott csomóponton helyezi üzembe az alkalmazásokat.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-TimeoutSec

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

Típus:Int32
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-UsePaging

Megadja, hogy a lekérdezés lapozott legyen-e. Ha nincs bejelölve, akkor ez a lekérdezés nem fog működni, ha túl sok találat van ahhoz, hogy egy oldalra férjen el a maximális üzenetméret-konfigurációban meghatározott módon. Ha ezt a beállítást választja, a lekérdezés úgy konfigurálja ezt a lekérdezést, hogy az összes eredményt visszaadja, függetlenül az üzenet maximális méretkonfigurációtól. Ezt úgy teszi, hogy lapozott eredményeket kap, és a hívó nevében transzparens módon végighalad az összes oldalon.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

System.String

System.Uri

Kimenetek

System.Object