Freigeben über


Get-ServiceFabricDeployedServicePackage

Ruft die Service Fabric-Dienstpakete auf einem Knoten ab.

Syntax

Get-ServiceFabricDeployedServicePackage
   [-NodeName] <String>
   [-ApplicationName] <Uri>
   [[-ServiceManifestName] <String>]
   [-IncludeHealthState]
   [-GetSinglePage]
   [-UsePaging]
   [-ContinuationToken <String>]
   [-MaxResults <Int64>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricDeployedServicePackage
   [-NodeName] <String>
   [-ApplicationName] <Uri>
   [[-ServiceManifestName] <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Beschreibung

Das cmdlet Get-ServiceFabricDeployedServicePackage ruft die bereitgestellten Service Fabric-Dienstpakete auf einem angegebenen Knoten ab.

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

Beispiele

Beispiel 1: Abrufen aller bereitgestellten Dienstpakete

PS C:\> Get-ServiceFabricDeployedServicePackage -NodeName "Node01" -ApplicationName fabric:/MyApplication

Dieser Befehl ruft alle bereitgestellten Dienstpakete für Anwendungs fabric:/MyApplication auf Knoten Node01 ab.

Beispiel 2: Abrufen des bereitgestellten Dienstpakets für das Dienstmanifest

PS C:\> Get-ServiceFabric DeployedServicePackage -NodeName "Node01" -ApplicationName fabric:/MyApplication -ServiceManifestName "CalcServicePackage"

Dieser Befehl ruft das Dienstpaket für Anwendungs fabric:/MyApplication auf Knoten Node01 für das Dienstmanifest CalcServicePackage ab.

Parameter

-ApplicationName

Gibt den URI (Uniform Resource Identifier) einer Service Fabric-Anwendung an. Das Cmdlet ruft das Dienstpaket für die von Ihnen angegebene Anwendung ab.

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

-ContinuationToken

Gibt das Fortsetzungstoken an, mit dem die nächste Seite der Abfrageergebnisse abgerufen werden kann.

Wenn zu viele Ergebnisse die bereitgestellten Filter berücksichtigen, passen sie möglicherweise nicht in eine Nachricht. Paging wird verwendet, um dies zu berücksichtigen, indem die Sammlung der zurückgegebenen Ergebnisse in separate Seiten aufgeteilt wird. Das Fortsetzungstoken wird verwendet, um zu wissen, wo die vorherige Seite aufgehört hat, wobei nur die Abfrage selbst von Bedeutung ist. Dieser Wert sollte aus der Ausführung dieser Abfrage generiert werden und kann an 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 mit Abfrageergebnissen mit einem Fortsetzungstokenwert zurückgibt, oder ob alle Seiten in einer Liste von Ergebnissen kombiniert werden. Wenn diese Option ausgewählt ist, liegt es in der 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

Schließen Sie den Integritätsstatus einer Entität ein. Wenn dieser Parameter false oder nicht angegeben ist, wird der zurückgegebene Integritätszustand Unknown. Bei Festlegung auf truewird die Abfrage parallel zum Knoten und zum Integritätssystemdienst ausgeführt, bevor die Ergebnisse zusammengeführt werden. Daher ist die Abfrage teurer und kann länger dauern.

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

-MaxResults

Gibt die maximale Anzahl von Ergebniselementen an, die pro Seite zurückgegeben werden können. Dadurch wird die obere Grenze für die Anzahl der zurückgegebenen Ergebnisse definiert, nicht mindestens. Wenn die Seite beispielsweise maximal 1000 zurückgegebene Elemente gemäß den in der Konfiguration definierten Einschränkungen für die maximale Nachrichtengröße einpasst und der MaxResults-Wert auf 2000 festgelegt ist, werden nur 1000 Ergebnisse zurückgegeben, auch wenn 2000 Ergebniselemente der Abfragebeschreibung entsprechen. Für diesen Wert ist die Auswahl des GetSinglePage-Flags erforderlich; andernfalls wird sie 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 Dienstpakete für den von Ihnen angegebenen Knoten ab.

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

-ServiceManifestName

Gibt den Namen eines Service Fabric-Dienstmanifests an. Das Cmdlet ruft Dienstpakete für das von Ihnen angegebene Dienstmanifest ab.

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

-TimeoutSec

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

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

-UsePaging

Gibt an, ob eine seitenseitige Version dieser Abfrage verwendet werden soll.

Wenn diese Abfrage nicht mehr angezeigt wird, wird die Anzahl der zurückgegebenen Ergebnisse durch die Konfiguration der maximalen Nachrichtengröße eingeschränkt. Wenn sie nicht angegeben ist und zu viele Anwendungstypen in eine Nachricht passen, schlägt die Abfrage fehl. Dem Benutzer werden keine Ergebnisse zurückgegeben. Wenn die Abfrage ausgelagert wird, werden die Ergebnisse aufgrund von Nachrichtengröße-Kontraintenten nicht gelöscht, da die Ergebnisse bei Bedarf in Seiten aufgeteilt und durchlaufen werden. Die Auslagerung erfolgt intern durch die Abfrage, und es sind keine zusätzlichen Schritte erforderlich.

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

Eingaben

System.String

System.Uri

Ausgaben

System.Object