New-ServiceFabricApplication
Crée une application Service Fabric.
Syntaxe
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
La cmdlet 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 d’application et la version proviennent du manifeste d’application dans le package d’application utilisé lors de l’inscription de l’application à l’aide de Register-ServiceFabricApplicationType cmdlet.
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 de l’application du package d’application utilisé lors de l’inscription de l’application à l’aide de '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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| 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 crée une application Service Fabric du type d’application que vous spécifiez.
| Type: | String |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 du cluster.
| Type: | Int64 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Metrics
Spécifie un tableau de métriques. Ces métriques sont utilisées par Service Fabric Cluster 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 Présentation de Service Fabric Cluster Resource Manager. 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 suivi d’une valeur de paramètre et séparé par un signe deux-points. Chaque paramètre name :value paire peut apparaître au maximum une fois.
- MetricName. Spécifie le nom de la métrique.
- NodeReservationCapacity. Spécifie la quantité de charge 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 si elle ne passe pas :
NodeReservationCapacity ne doit pas être supérieur à MaximumNodeCapacity.
Si la métrique MinimumNodes et NodeReservationCapacity sont spécifiées, le produit de MinimumNodes et NodeReservationCapacity ne doit pas être supérieur à TotalApplicationCapacity. Pour plus d’informations, consultez Métriques d’application, Chargement et capacité
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 zéro, ce qui signifie qu’aucune capacité n’est réservée à l’application.
| Type: | Int64 |
| 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 |
Entrées
None
Sorties
System.Object