Freigeben über

Get-ServiceFabricDeployedApplication

  • Referenz
Modul:
ServiceFabric

Ruft die Service Fabric-Anwendung(n) auf einem angegebenen Knoten ab.

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>]

Beschreibung

Das Cmdlet "Get-ServiceFabricDeployedApplication" ruft die Service Fabric-Anwendung (n) auf einem angegebenen Knoten ab.

Service Fabric erstellt Arbeits-, Protokoll- und temporäre Verzeichnisse im Knoten für jede bereitgestellte Anwendung. Da die Verzeichnisnamen die Anwendungs-ID enthalten, können die Verzeichnisnamen nicht erraten werden. Wenn die BereitstellungApplicationStatus aktiv ist, gibt Get-ServiceFabricDeployedApplication die Verzeichnisnamen in der Arbeitsverzeichnis-, LogDirectory- und TempDirectory-Rückgabewerte zurück. Wenn der BereitgestelltApplicationStatus heruntergeladen wird, sind die Werte "WorkDirectory", "LogDirectory" und " TempDirectory " null.

Die bereitgestellten Anwendungsdienste speichern ihre gespeicherten Daten im WorkDirectory. Bei Debuggen oder Diagnosezwecken muss möglicherweise eine andere Anwendung oder ein anderer Prozess den Speicherort des WorkDirectory kennen.

Die bereitgestellten Anwendungsdienste sollten ihr Protokoll im von Service Fabric erstellten LogDirectory speichern. Möglicherweise muss ein benutzerdefinierter Uploader der Protokolldateien den Speicherort kennen. Der Speicherort des LogDirectory kann auch für Diagnosezwecke erforderlich sein, wenn eine Anwendung auf einem bestimmten Knoten nicht wie erwartet funktioniert.

Standardmäßig gibt diese Abfrage eine Reihe von Ergebnissen zurück, die auf die maximale Nachrichtengröße-Konfiguration beschränkt sind. SDKs und Clusterversionen 6.1 oder neuer unterstützt die Pagingfunktionalität, die diese Einschränkung entfernt; das neue Verhalten besteht darin, die Ergebnisse unabhängig von der Konfiguration der maximalen Nachrichtengröße zurückzugeben, da diese Abfrage transparent durch alle zurückgegebenen Seiten durchläuft. Informationen zum Verwenden von Seiten und anderen neuen Funktionen finden Sie im Parametersatz "UsePagedAPI". Wählen Sie alle neuen Filtersignale an die Abfrage aus, um das Paging unter der Haube zu verwenden. Wählen Sie andernfalls "UsePaging" aus, um sich bei der Seitenabfrage anzumelden.

Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Abrufen der Anwendung "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

Dieser Befehl gibt bereitgestellte Anwendungen zurück. In diesem Beispiel ist der BereitstellungApplicationStatus active, und daher gibt Get-ServiceFabricDeployedApplication die Verzeichnisnamen in der Arbeitsverzeichnis-, LogDirectory- und TempDirectory-Rückgabewerte zurück.

Beispiel 2: Abrufen der Anwendung "fabric:/samples/VQueueApp2"

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

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

Dieser Befehl gibt bereitgestellte Anwendungen zurück. In diesem Beispiel wird der BereitgestelltApplicationStatus heruntergeladen, und daher gibt der Befehl Werte von Null für WorkDirectory, LogDirectory und TempDirectory zurück.

Beispiel 3: Abrufen von Anwendungen mit max. Ergebnissen

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

Dieser Befehl ruft alle Dienst Fabric-Anwendungen ab, die auf dem bereitgestellten Knoten im Cluster bereitgestellt werden, der auf eine Seite passt. Die Größe der Seite ist weiter auf zwei Elemente beschränkt, wie vom MaxResults-Parameter konfiguriert. Da wir die Option "GetSinglePage" ausgewählt haben, gibt diese Abfrage nur eine Seite von Ergebnissen zurück. MaxResults können ohne diese Option nicht verwendet werden. Wenn Sie "Verbose" auswählen, wird der zurückgegebene Fortsetzungstokenwert gedruckt. Dieser Wert kann in einer nachfolgenden Abfrage verwendet werden, um die nächste Seite der Ergebnisse abzurufen. Sie können auch auf das zurückgegebene Fortsetzungstoken zugreifen, indem Sie die zurückgegebenen Ergebnisse speichern und auf die Eigenschaft "ContinuationToken" zugreifen. Die Eigenschaft "ContinuationToken" ist null, es gibt kein zurückgegebenes Fortsetzungstoken.

Beispiel 4: Abrufen der Anwendung mit Fortsetzungstoken

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

Dieser Befehl ruft die Service Fabric-Anwendung ab, die das bereitgestellte Fortsetzungstoken berücksichtigt, das in eine einzelne Seite passt. Das für diese Abfrage bereitgestellte Fortsetzungstoken ist dieselbe, die vom obigen Beispiel zurückgegeben wird. In diesem Beispielcluster gibt es nur ein Element, das das Fortsetzungstoken berücksichtigt. Wenn es zu viele Anwendungen gibt, die das bereitgestellte Fortsetzungstoken auf dem Knoten berücksichtigen, um in eine Seite der Ergebnisse passen zu können, gibt diese Abfragekonfiguration eine Kompilierung aller zurückgegebenen Seiten zurück, die sie transparent durchlaufen; die Abfrage gibt dann einen Vektor aller Ergebnisse zurück. Um nur eine Seite von Ergebnissen abzurufen, wählen Sie die Option "GetSinglePage" aus.

Beispiel 5: Abrufen der Anwendung mit Integritätsstatus

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

Dieser Befehl ruft die Service Fabric-Anwendung ab, die dem angegebenen Anwendungsnamen entspricht und den Integritätsstatus enthält.

Parameter

-ApplicationName

Gibt den Uniform Resource Identifier (URI) einer Service Fabric-Anwendung an. Das Cmdlet ruft die bereitgestellte Anwendung ab, die dem angegebenen Anwendungsnamen entspricht. Diese Abfrage führt eine genaue Übereinstimmung durch. Beispielsweise entspricht der URI Fabric:/App nicht mit Fabric:/App1. Am meisten wird ein Ergebnis zurückgegeben, wenn der Anwendungsname bereitgestellt wird. Wenn der angegebene Anwendungsname nicht mit einer Anwendung auf dem Knoten übereinstimmt, gibt die Abfrage null zurück.

Typ:Uri
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ContinuationToken

Gibt das Fortsetzungstoken an, das zum Abrufen der nächsten Seite der Abfrageergebnisse verwendet werden kann.

Wenn zu viele Ergebnisse die bereitgestellten Filter berücksichtigen, passen sie möglicherweise nicht in eine Nachricht. Das Paging wird verwendet, um dies zu berücksichtigen, indem die Auflistung der zurückgegebenen Ergebnisse in separate Seiten aufgeteilt wird. Das Fortsetzungstoken wird verwendet, um zu wissen, wo die vorherige Seite abgelassen wurde, wobei nur die Bedeutung für die Abfrage selbst besteht. Dieser Wert sollte aus der Ausführung dieser Abfrage generiert werden und kann in die nächste Abfrageanforderung übergeben werden, um nachfolgende Seiten abzurufen. Ein Nicht-Null-Fortsetzungstokenwert wird nur als Teil des Ergebnisses zurückgegeben, wenn eine nachfolgende Seite vorhanden ist. Wenn dieser Wert ohne die Option -GetSinglePage bereitgestellt wird, gibt die Abfrage alle Seiten ab dem Fortsetzungstokenwert zurück.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GetSinglePage

Gibt an, ob die Abfrage eine Seite von Abfrageergebnissen mit einem Fortsetzungstokenwert zurückgibt oder alle Seiten in einer Liste der Ergebnisse kombiniert werden. Wenn diese Option ausgewählt ist, ist es die Verantwortung des Aufrufers der Abfrage, nach nachfolgenden Seiten zu suchen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeHealthState

Gibt an, ob die Abfrage den Integritätszustand der bereitgestellten Anwendungen zurückgibt. Wenn dieser Parameter nicht angegeben wird, ist der zurückgegebene Integritätszustand "Unbekannt". Bei Auswahl wird die Abfrage parallel zum Knoten und dem Integritätssystemdienst ausgeführt, bevor die Ergebnisse zusammengeführt werden. Daher ist die Abfrage teurer und kann längere Zeit in Anspruch nehmen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxResults

Gibt die maximale Anzahl der Ergebniselemente an, die pro Seite zurückgegeben werden können. Dies definiert die obere Grenze für die Anzahl der zurückgegebenen Ergebnisse, nicht mindestens. Wenn die Seite z. B. 1000 zurückgegebene Elemente gemäß den in der Konfiguration definierten Einschränkungen der Nachrichtengröße passt und der MaxResults-Wert auf 2000 festgelegt ist, werden nur 1000 Ergebnisse zurückgegeben, auch wenn 2000 Ergebniselemente der Abfragebeschreibung entsprechen.

Dieser Wert erfordert die Auswahl des GetSinglePage-Flags; andernfalls wird er ignoriert.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeName

Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet ruft Anwendungen auf dem knoten ab, den Sie angeben.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UsePaging

Gibt an, ob die Abfrage paged wird. Wenn nicht ausgewählt, funktioniert diese Abfrage nicht, wenn es zu viele Ergebnisse gibt, die auf eine Seite passen, wie durch die Max.-Nachrichtengröße-Konfiguration definiert. Wenn Sie diese Option auswählen, wird diese Abfrage so konfiguriert, dass alle Ergebnisse zurückgegeben werden, unabhängig von der Max.-Nachrichtengröße-Konfiguration. Dadurch werden seitenseitige Ergebnisse abgerufen und alle Seiten transparent im Auftrag des Anrufers durchlaufen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.String

System.Uri

Ausgaben

System.Object