New-ServiceFabricApplication
Crée une application Service Fabric.
Syntax
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
L’applet de commande New-ServiceFabricApplication crée une application Service Fabric d’un type d’application inscrit. Utilisez l’applet de commande Register-ServiceFabricApplicationType pour inscrire un type d’application.
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 : créer une application
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"
Cette commande crée une application de type PersistentToDoListApp. L’application est la version 1.0. Le type et la version de l’application proviennent du manifeste d’application dans le package d’application utilisé lors de l’inscription de l’application à l’aide de l’applet de commande Register-ServiceFabricApplicationType .
Exemple 2 : Créer une application en remplaçant les valeurs de paramètre par défaut dans le manifeste de l’application
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}
Cette commande crée une application de type PersistentToDoListApp et version 1.0 avec des valeurs substituées pour les paramètres CustomParameter1 et CustomParameter2. Ces noms de paramètres doivent exister dans le manifeste d’application du package d’application utilisé lors de l’inscription de l’application à l’aide de l’applet de commande Register-ServiceFabricApplicationType .
Paramètres
-ApplicationName
Spécifie l’URI (Uniform Resource Identifier) d’une application Service Fabric. L’applet de commande crée une application Service Fabric avec le nom que vous spécifiez.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationParameter
Spécifie les remplacements pour les paramètres d’application définis dans le manifeste de l’application en tant que paires clé/valeur. L’applet de commande crée une application Service Fabric du type d’application et utilise les valeurs substituées pour ces paramètres. Les paramètres qui sont substitués ici doivent exister dans le manifeste de l’application.
Type: | Hashtable |
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 crée une application Service Fabric du type d’application que vous spécifiez.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationTypeVersion
Spécifie la version d’un type d’application Service Fabric. L’applet de commande crée une application qui a la version que vous spécifiez.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumNodes
Spécifie le nombre maximal de nœuds sur lesquels placer une application. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est 0, ce qui indique que l’application peut être placée sur n’importe quel nombre de nœuds dans le cluster.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metrics
Spécifie un tableau de métriques. Ces métriques sont utilisées par le cluster Service Fabric Resource Manager pour gérer les ressources dans le cluster. Pour plus d’informations sur les métriques et la gestion des ressources dans Service Fabric, consultez La Resource Manager Présentation du cluster Service Fabric. Chaque métrique peut suivre le modèle MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity, ou spécifier MetricName et utiliser des noms de paramètres NodeReservationCapacity, MaximumNodeCapacity ou TotalApplicationCapacity suivis d’une valeur de paramètre et séparés par un signe deux-points. Chaque paire nom de paramètre:value peut apparaître au plus une fois.
- MetricName. Spécifie le nom de la métrique.
- NodeReservationCapacity. Spécifie la quantité de charge de métrique réservée sur les nœuds qui ont des instances de cette application. Si MinimumNodes est spécifié, le produit de ces valeurs est la capacité réservée dans le cluster pour l’application.
- MaximumNodeCapacity. Spécifie la charge maximale d’une instance de cette application sur un seul nœud. Même si la capacité du nœud est supérieure à cette valeur, Service Fabric limite la charge totale des réplicas enfants de l’application à cette valeur.
- TotalApplicationCapacity. Spécifie la capacité totale de l’application dans le cluster. Service Fabric tente de limiter la somme des charges des réplicas enfants de l’application à cette valeur.
Lors de la création de l’application, Service Fabric effectue les validations suivantes et échoue la commande s’ils ne réussissent pas :
NodeReservationCapacity ne doit pas être supérieur à MaximumNodeCapacity.
Si le paramètre MinimumNodes et la métrique NodeReservationCapacity sont spécifiés, le produit de MinimumNodes et NodeReservationCapacity ne doit pas être supérieur à TotalApplicationCapacity. Pour plus d’informations, consultez Métriques d’application, Charge et Capacité
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumNodes
Spécifie le nombre minimal de nœuds où Service Fabric réserve la capacité pour cette application, cela ne signifie pas que l’application est garantie d’avoir des réplicas sur tous ces nœuds. La valeur de ce paramètre doit être un entier non négatif. La valeur par défaut est égale à zéro, ce qui signifie qu’aucune capacité n’est réservée à l’application.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
Spécifie le délai 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 |
Entrées
None
Sorties
System.Object