New-ServiceFabricApplication
Crea una aplicación de Service Fabric.
Syntax
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
El cmdlet New-ServiceFabricApplication crea una aplicación de Service Fabric de un tipo de aplicación registrado. Use el cmdlet Register-ServiceFabricApplicationType para registrar un tipo de aplicación.
Antes de realizar cualquier operación en un clúster de Service Fabric, establezca una conexión con el clúster mediante el cmdlet Connect-ServiceFabricCluster .
Ejemplos
Ejemplo 1: crear un rol de aplicación
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"Este comando crea una aplicación del tipo PersistentToDoListApp. La aplicación es la versión 1.0. El tipo de aplicación y la versión proceden del manifiesto de aplicación en el paquete de aplicación que se usó al registrar la aplicación mediante el cmdlet Register-ServiceFabricApplicationType .
Ejemplo 2: Creación de una aplicación reemplazando los valores de parámetro predeterminados en el manifiesto de aplicación
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}Este comando crea una aplicación del tipo PersistentToDoListApp y la versión 1.0 con valores invalidados para los parámetros CustomParameter1 y CustomParameter2. Estos nombres de parámetro deben existir en el manifiesto de aplicación del paquete de aplicación que se usó al registrar la aplicación mediante el cmdlet Register-ServiceFabricApplicationType .
Parámetros
-ApplicationName
Especifica el identificador uniforme de recursos (URI) de una aplicación de Service Fabric. El cmdlet crea una aplicación de Service Fabric con el nombre que especifique.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationParameter
Especifica las invalidaciones de los parámetros de aplicación definidos en el manifiesto de aplicación como pares clave-valor. El cmdlet crea una aplicación de Service Fabric del tipo de aplicación y usa los valores invalidados para estos parámetros. Los parámetros que se reemplazan aquí deben existir en el manifiesto de aplicación.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeName
Especifica el nombre de un tipo de aplicación de Service Fabric. El cmdlet crea una aplicación de Service Fabric del tipo de aplicación que especifique.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeVersion
Especifica la versión de un tipo de aplicación de Service Fabric. El cmdlet crea una aplicación que tiene la versión que especifique.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumNodes
Especifica el número máximo de nodos en los que se va a colocar una aplicación. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado es 0, lo que indica que la aplicación se puede colocar en cualquier número de nodos del clúster.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metrics
Especifica una matriz de métricas. El clúster de Service Fabric usa estas métricas Resource Manager para administrar los recursos del clúster. Para más información sobre las métricas y la administración de recursos en Service Fabric, consulte Introducción al clúster de Service Fabric Resource Manager. Cada métrica puede seguir el patrón MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity o puede especificar MetricName y usar nombres de parámetro NodeReservationCapacity, MaximumNodeCapacity o TotalApplicationCapacity seguidos de un valor de parámetro y separados por dos puntos. Cada par nombre:valor de parámetro puede aparecer como máximo una vez.
- MetricName. Especifica el nombre de la métrica.
- NodeReservationCapacity. Especifica la cantidad de carga de métricas reservada en los nodos que tienen instancias de esta aplicación. Si se especifica MinimumNodes , el producto de estos valores es la capacidad reservada en el clúster para la aplicación.
- MaximumNodeCapacity. Especifica la carga máxima para una instancia de esta aplicación en un único nodo. Incluso si la capacidad del nodo es mayor que este valor, Service Fabric limita la carga total de las réplicas secundarias de la aplicación a este valor.
- TotalApplicationCapacity. Especifica la capacidad total de la aplicación en el clúster. Service Fabric intenta limitar la suma de cargas de las réplicas secundarias de la aplicación a este valor.
Al crear la aplicación, Service Fabric realiza las siguientes validaciones y producirá un error en el comando si no pasan:
NodeReservationCapacity no debe ser mayor que MaximumNodeCapacity.
Si se especifican tanto el parámetro MinimumNodes como la métrica NodeReservationCapacity, el producto de MinimumNodes y NodeReservationCapacity no debe ser superior a TotalApplicationCapacity. Para más información, consulte Métricas de aplicación, carga y capacidad.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumNodes
Especifica el número mínimo de nodos en los que Service Fabric reservará capacidad para esta aplicación, lo que no significa que se garantice que la aplicación tenga réplicas en todos esos nodos. El valor de este parámetro debe ser un entero no negativo. El valor predeterminado para esto es cero, lo que significa que no hay capacidad reservada para la aplicación.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Especifica el período de tiempo de espera, en segundos, para la operación.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
None
Salidas
System.Object