Get-ServiceFabricApplicationType
Ruft die Service Fabric-Anwendungstypen ab, die im Service Fabric-Cluster registriert sind und den bereitgestellten Filtern entsprechen.
Syntax
UsePagedAPI (Standard)
Get-ServiceFabricApplicationType
[[-ApplicationTypeName] <String>]
[[-ApplicationTypeVersion] <String>]
[-ApplicationTypeDefinitionKindFilter <ApplicationTypeDefinitionKindFilter>]
[-ExcludeApplicationParameters]
[-UsePaging]
[-TimeoutSec <Int32>]
[<CommonParameters>]
UseUnpagedAPI
Get-ServiceFabricApplicationType
[[-ApplicationTypeName] <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Beschreibung
Mit dem Cmdlet Get-ServiceFabricApplicationType werden die Service Fabric-Anwendungstypen abgerufen, die im Service Fabric-Cluster registriert sind oder registriert sind und den bereitgestellten Filtern entsprechen. 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 auf einem Service Fabric Cluster durchführen, stellen Sie mit dem Cmdlet Connect-ServiceFabricCluster eine Verbindung zu dem Cluster her.
Beispiele
Beispiel 1: Abrufen aller registrierten oder registrierenden Anwendungstypen
PS C:\> Get-ServiceFabricApplicationType
Mit diesem Befehl werden alle registrierten Anwendungstypen abgerufen.
Beispiel 2: Abrufen eines registrierten oder registrierenden 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"
Mit diesem Befehl werden alle Versionen des Anwendungstyps "TestApp" abgerufen. Dadurch wird der Anwendungstyp "TestApp2" nicht abgerufen, da der Name des Anwendungstyps nicht genau übereinstimmt.
Beispiel 3: Abrufen aller registrierten oder registrierenden Anwendungstypen ohne Standardanwendungsparameter
PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters
Mit diesem Befehl werden alle registrierten Anwendungstypen abgerufen. Die zurückgegebenen System.Fabric.Query.ApplicationType-Objekte verfügen über eine nicht ausgefüllte DefaultParameters-Eigenschaft, unabhängig davon, ob der Anwendungstyp über Standardanwendungsparameter verfügt.
Beispiel 4: Abrufen aller registrierten oder registrierenden Anwendungstypen mit Auslagerung und anschließender Weiterleitung
PS C:\> Get-ServiceFabricApplicationType -UsePaging | Get-ServiceFabricApplicationManifest
Mit diesem Befehl werden alle registrierten oder registrierenden Anwendungstypen mithilfe von Paging abgerufen. Dies bedeutet, dass Nachrichten nicht gelöscht werden, wenn sie nicht in eine Nachricht passen, deren Größe durch die Konfiguration der maximalen Nachrichtengröße bestimmt wird. Das Paging erfolgt im Hintergrund durch die Abfrage. Rohrleitungen und andere Funktionen bleiben unverändert.
Parameter
-ApplicationTypeDefinitionKindFilter
Gibt den Filter für ApplicationTypeDefinitionKindFilter basierend auf der Definition des Anwendungstyps an. Der Wert kann aus Membern oder bitweisen Vorgängen für Member von ApplicationTypeDefinitionKindFilter abgerufen werden. Es werden nur Anwendungstypen zurückgegeben, die dem Filter entsprechen. ApplicationTypeName und ApplicationTypeDefinitionKindFilter können nicht zusammen angegeben werden.
Parametereigenschaften
| Typ: | ApplicationTypeDefinitionKindFilter |
| Standardwert: | None |
| Zulässige Werte: | Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
UsePagedAPI
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ApplicationTypeName
Gibt den Namen eines Service Fabric-Anwendungstyps an. Das Cmdlet ruft alle Versionen des von Ihnen angegebenen Namens des Anwendungstyps ab.
Wenn Sie diesen Parameter nicht angeben, ruft dieses Cmdlet alle Anwendungstypen ab. Dieser Parameter stimmt mit den exakten Anwendungstypnamen überein, bei denen zwischen Groß- und Kleinschreibung unterschieden wird, die im Anwendungsmanifest aller bereitgestellten oder bereitgestellten Anwendungstypen definiert sind. Der Wert "Test" stimmt z. B. nicht mit "TestApp" überein, da es sich nur um eine Teilübereinstimmung handelt. Dieser Wert sollte nicht die Version des Anwendungstyps enthalten und stimmt mit allen Versionen desselben Anwendungstypnamens überein.
ApplicationTypeName und ApplicationTypeDefinitionKindFilter können nicht zusammen angegeben werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ApplicationTypeVersion
Gibt die Version eines Service Fabric-Anwendungstyps an. Das Cmdlet ruft den Anwendungstyp ab, der dem angegebenen Namen und der angegebenen Version des Anwendungstyps entspricht.
Geben Sie diesen Parameter nur an, wenn Sie auch den Parameter ApplicationTypeName angeben. Dieser Parameter führt einen Filter zusätzlich zum ApplicationTypeName-Filter aus. Sie stimmt mit der genauen Version des Anwendungstyps überein, bei der zwischen Groß- und Kleinschreibung unterschieden wird, die im Anwendungsmanifest eines bereitgestellten oder Bereitstellungsanwendungstyps definiert ist. Der Wert "Version" stimmt z. B. nicht mit "Version1" überein, da es sich nur um eine teilweise Übereinstimmung handelt. Dieser Wert sollte nicht den Namen des Anwendungstyps enthalten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
UsePagedAPI
| Position: | 1 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ExcludeApplicationParameters
Gibt an, ob Standardanwendungsparameter aus dem Abfrageergebnis ausgeschlossen werden sollen.
Wenn diese Option festgelegt ist, ist das Feld für die Standardanwendungsparameter weiterhin sichtbar, aber leer.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
UsePagedAPI
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-TimeoutSec
Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-UsePaging
Gibt an, ob eine ausgelagerte Version dieser Abfrage verwendet werden soll.
Wenn diese Abfrage nicht ausgelagert ist, wird die Anzahl der zurückgegebenen Ergebnisse durch die Konfiguration der maximalen Nachrichtengröße eingeschränkt. Wenn nicht angegeben wird und zu viele Anwendungstypen vorhanden sind, um in eine Nachricht zu passen, schlägt die Abfrage fehl. Es werden keine Ergebnisse an den Benutzer zurückgegeben. Wenn die Abfrage ausgelagert wird, werden die Ergebnisse aufgrund von Einschränkungen bei der Nachrichtengröße nicht verworfen, da die Ergebnisse bei Bedarf in Seiten aufgeteilt und in einer Schleife durchlaufen werden. Das Paging erfolgt intern durch die Abfrage, und es sind keine zusätzlichen Schritte erforderlich.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
UsePagedAPI
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.