Get-ServiceFabricApplicationType

  • Referenz
Modul:
ServiceFabric

Ruft die Dienst Fabric-Anwendungstypen ab, die im Service Fabric-Cluster registriert sind, der den bereitgestellten Filtern entspricht.

Syntax

Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [[-ApplicationTypeVersion] <String>]
   [-ApplicationTypeDefinitionKindFilter <ApplicationTypeDefinitionKindFilter>]
   [-ExcludeApplicationParameters]
   [-UsePaging]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricApplicationType
   [[-ApplicationTypeName] <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-ServiceFabricApplicationType " ruft die Dienst Fabric-Anwendungstypen ab, die auf dem Service Fabric-Cluster registriert oder registriert werden, der den bereitgestellten Filtern entspricht. Jede Version eines Anwendungstyps wird als einzelnes Ergebnis im Ergebnisarray zurückgegeben. Wenn keine Anwendungstypen gefunden werden, die den angegebenen Parametern entsprechen, gibt diese Abfrage nichts zurück.

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 aller registrierten oder registrierten Anwendungstypen

PS C:\> Get-ServiceFabricApplicationType

Dieser Befehl ruft alle registrierten Anwendungstypen ab.

Beispiel 2: Abrufen des registrierten oder registrieren des Anwendungstyps mit angegebenen Typnamen

PS C:\> # Scenario: multiple application types are provisioned in the cluster, including TestApp versions 1 and 2, as well as TestApp2 version 1.
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "TestApp"

Dieser Befehl ruft alle Versionen des Anwendungstyps "TestApp" ab. Dadurch wird der Anwendungstyp "TestApp2" nicht abgerufen, da der Anwendungstypname keine genaue Übereinstimmung ist.

Beispiel 3: Abrufen aller registrierten oder registrierten Anwendungstypen ohne Standardanwendungsparameter

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

Dieser Befehl ruft alle registrierten Anwendungstypen ab. Das zurückgegebene System.Fabric.Query.ApplicationType-Objekt (s) verfügt über eine nicht aufgefüllte DefaultParameters-Eigenschaft, unabhängig davon, ob der Anwendungstyp Standardanwendungsparameter aufweist.

Beispiel 4: Abrufen aller registrierten oder registrierenden Anwendungstypen mit Paging und anschließender Leitung

PS C:\> Get-ServiceFabricApplicationType -UsePaging | Get-ServiceFabricApplicationManifest

Dieser Befehl ruft alle registrierten oder registrierten Anwendungstypen mithilfe von Paging ab. Dies bedeutet, dass Nachrichten nicht gelöscht werden, wenn sie nicht in eine Nachricht passen, deren Größe durch die max. Messaage-Größenkonfiguration bestimmt wird. Das Paging erfolgt hinter den Kulissen der Abfrage. Die Leitung und andere Funktionen bleiben unverändert.

Parameter

-ApplicationTypeDefinitionKindFilter

Gibt den Filter für ApplicationTypeDefinitionKindFilter basierend auf der Definition des Anwendungstyps an. Der Wert kann von Mitgliedern oder Bitzeigervorgängen auf Mitgliedern von ApplicationTypeDefinitionKindFilter abgerufen werden. Nur Anwendungen, die dem Filter entsprechen, werden zurückgegeben. ApplicationTypeName und ApplicationTypeDefinitionKindFilter können nicht zusammen angegeben werden.

Typ:ApplicationTypeDefinitionKindFilter
Zulässige Werte:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationTypeName

Gibt den Namen eines Dienst Fabric-Anwendungstyps an. Das Cmdlet ruft alle Versionen des Anwendungstypnamens ab, den Sie angeben.

Wenn Sie diesen Parameter nicht angeben, ruft dieses Cmdlet alle Anwendungstypen ab. Dieser Parameter entspricht den namen der genauen Groß-/Kleinschreibung, die im Anwendungsmanifest aller bereitgestellten oder bereitstellungsanwendungstypen definiert sind. Der Wert "Test" stimmt z. B. nicht mit "TestApp" überein, da es nur eine Teileinstimmung ist. Dieser Wert sollte nicht die Version des Anwendungstyps enthalten und entspricht allen Versionen desselben Anwendungstyps.

ApplicationTypeName und ApplicationTypeDefinitionKindFilter können nicht zusammen angegeben werden.

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

-ApplicationTypeVersion

Gibt die Version eines Service Fabric-Anwendungstyps an. Das Cmdlet ruft den Anwendungstyp ab, der dem angegebenen Anwendungstypnamen und der Version entspricht.

Geben Sie diesen Parameter nur an, wenn sie auch den ApplicationTypeName-Parameter bereitstellen. Dieser Parameter führt einen Filter oben im ApplicationTypeName-Filter aus. Es entspricht der in der Anwendungsmanifestdatei eines bereitgestellten oder bereitstellungsanwendungstyps definierten Typs der Groß-/Kleinschreibung. Der Wert "Version" stimmt z. B. nicht mit "Version1" überein, da es nur eine teilielle Übereinstimmung ist. Dieser Wert sollte nicht den Namen des Anwendungstyps enthalten.

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

-ExcludeApplicationParameters

Gibt an, ob Standardanwendungsparameter aus dem Abfrageergebnis ausgeschlossen werden sollen.

Wenn festgelegt, ist das Feld für die Standardanwendungsparameter weiterhin sichtbar, ist aber leer.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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 eine seitenseitige Version dieser Abfrage verwendet werden soll.

Wenn diese Abfrage nicht angezeigt wird, wird die Anzahl der zurückgegebenen Ergebnisse durch die maximale Nachrichtengrößeskonfiguration eingeschränkt. Wenn nicht angegeben und es gibt zu viele Anwendungstypen, die in eine Nachricht passen, schlägt die Abfrage fehl. Es werden keine Ergebnisse an den Benutzer zurückgegeben. Wenn die Abfrage paged ist, werden die Ergebnisse aufgrund von Nachrichtengröße-Kontraintenten nicht gelöscht, da die Ergebnisse nach Bedarf in Seiten unterteilt und durchgeschleifet werden. Die Paging wird intern durch die Abfrage durchgeführt, 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

Ausgaben

System.Object