Partager via


Get-ServiceFabricApplicationType

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

Syntax

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

Description

L’applet de commande 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’application inscrits ou inscrits

PS C:\> Get-ServiceFabricApplicationType

Cette commande obtient tous les types d’application inscrits.

Exemple 2 : Obtenir un 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’application inscrits ou inscrits sans paramètres d’application par défaut

PS C:\>Get-ServiceFabricApplicationType -ExcludeApplicationParameters

Cette commande obtient tous les types d’application inscrits. Les objets System.Fabric.Query.ApplicationType 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’application inscrits ou inscrits avec pagination, puis piping

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

Cette commande obtient tous les types d’application 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 messaage. La pagination est effectuée en arrière-plan par la requête. Piping et 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 d’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
Accepted values:Default, ServiceFabricApplicationPackage, Compose, MeshApplicationDescription, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 type 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 en haut du filtre ApplicationTypeName. Il correspond à la version exacte exacte du type d’application respectant la casse définie dans le manifeste d’application d’un type d’application provisionné ou provisionné. 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

Spécifie la période d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UsePaging

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

Si cette requête n’est pas mise en page, 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 existe 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 si 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

System.String

Sorties

System.Object