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