Partager via


Get-ServiceFabricApplicationType

Obtient les types d’applications Service Fabric inscrits sur le cluster Service Fabric qui correspondent aux filtres fournis.

Syntaxe

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

Description

La cmdlet Get-ServiceFabricApplicationType obtient les types d’applications Service Fabric inscrits ou inscrits sur le cluster Service Fabric qui correspondent aux filtres fournis. Chaque version d’un type d’application est retournée en tant que résultat individuel dans le tableau de résultats. Si aucun type d’application ne correspond aux paramètres fournis, cette requête ne retourne rien.

Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster.

Exemples

Exemple 1 : Obtenir tous les types d’applications inscrits ou inscrits

PS C:\> Get-ServiceFabricApplicationType

Cette commande obtient tous les types d’applications inscrits.

Exemple 2 : Obtenir le type d’application inscrit ou inscrit avec des noms de types spécifiés

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"

Cette commande obtient toutes les versions du type d’application « TestApp ». Cela n’obtient pas le type d’application « TestApp2 », car le nom du type d’application n’est pas une correspondance exacte.

Exemple 3 : Obtenir tous les types d’applications inscrits ou inscrits sans paramètres d’application par défaut

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

Cette commande obtient tous les types d’applications inscrits. Les System.Fabric.Query.ApplicationType objet(s) retournés ont une propriété DefaultParameters non renseignée, que le type d’application ait des paramètres d’application par défaut.

Exemple 4 : Obtenir tous les types d’applications inscrits ou inscrits avec pagination, puis piping

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

Cette commande obtient tous les types d’applications inscrits ou inscrits à l’aide de la pagination. Cela signifie que les messages ne sont pas supprimés s’ils ne correspondent pas à un message, dont la taille est déterminée par la configuration maximale de la taille de la mémoire. La pagination est effectuée en arrière-plan par la requête. La piping et d’autres fonctionnalités restent inchangées.

Paramètres

-ApplicationTypeDefinitionKindFilter

Spécifie le filtre pour ApplicationTypeDefinitionKindFilter en fonction de la façon dont le type d’application est défini. La valeur peut être obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de ApplicationTypeDefinitionKindFilter. Seuls les types d’applications qui correspondent au filtre sont retournés. ApplicationTypeName et ApplicationTypeDefinitionKindFilter ne peuvent pas être spécifiés ensemble.

Type:ApplicationTypeDefinitionKindFilter
Valeurs acceptées:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationTypeName

Spécifie le nom d’un type d’application Service Fabric. L’applet de commande obtient toutes les versions du nom de type d’application que vous spécifiez.

Si vous ne spécifiez pas ce paramètre, cette applet de commande obtient tous les types d’application. Ce paramètre correspond aux noms de types d’application exacts respectant la casse définis dans le manifeste de l’application de tous les types d’application approvisionnés ou approvisionnés. Par exemple, la valeur « Test » ne correspond pas à « TestApp », car elle n’est qu’une correspondance partielle. Cette valeur ne doit pas contenir la version du type d’application et correspond à toutes les versions du même nom de type d’application.

ApplicationTypeName et ApplicationTypeDefinitionKindFilter ne peuvent pas être spécifiés ensemble.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ApplicationTypeVersion

Spécifie la version d’un type d’application Service Fabric. L’applet de commande obtient le type d’application qui correspond au nom et à la version de type d’application spécifiés.

Fournissez uniquement ce paramètre si vous fournissez également le paramètre ApplicationTypeName. Ce paramètre effectue un filtre au-dessus du filtre ApplicationTypeName. Il correspond à la version de type d’application exacte sensible à la casse définie dans le manifeste de l’application d’un type d’application provisionné ou approvisionné. Par exemple, la valeur « Version » ne correspond pas à « Version1 », car elle n’est qu’une correspondance partielle. Cette valeur ne doit pas contenir le nom du type d’application.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ExcludeApplicationParameters

Spécifie s’il faut exclure les paramètres d’application par défaut du résultat de la requête.

Si elle est définie, le champ paramètres d’application par défaut est toujours visible, mais est vide.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie le délai d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UsePaging

Spécifie s’il faut utiliser une version paginée de cette requête.

Si cette requête n’est pas paginé, le nombre de résultats retournés est limité par la configuration maximale de la taille du message. S’il n’est pas spécifié et qu’il y a trop de types d’application pour s’adapter à un message, la requête échoue. Aucun résultat n’est retourné à l’utilisateur. Si la requête est paginée, les résultats ne sont pas supprimés en raison de contraintes de taille de message, car les résultats sont divisés en pages lorsque nécessaire et en boucle. La pagination est effectuée en interne par la requête et aucune étape supplémentaire n’est requise.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

System.String

Sorties

System.Object