New-ServiceFabricApplication
Crea una aplicación de Service Fabric.
Sintaxis
Default (valor predeterminado)
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: Creación de una 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 y la versión de la aplicació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 mediante la anulación de los valores de parámetro predeterminados en el manifiesto de la 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.
Propiedades de parámetro
| Tipo: | Uri |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 invalidan aquí deben existir en el manifiesto de aplicación.
Propiedades de parámetro
| Tipo: | Hashtable |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 2 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-MaximumNodes
Especifica el número máximo de nodos en los que 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.
Propiedades de parámetro
| Tipo: | Int64 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Metrics
Especifica una matriz de métricas. Service Fabric Cluster Resource Manager usa estas métricas para administrar los recursos del clúster. Para obtener más información sobre las métricas y la administración de recursos en Service Fabric, consulte Introducción al Administrador de recursos del clúster de Service Fabric. Cada métrica puede seguir el patrón MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity, o puede especificar MetricName y usar los nombres de parámetro NodeReservationCapacity, MaximumNodeCapacity o TotalApplicationCapacity seguidos de un valor de parámetro y separados por dos puntos. Cada par nombre:valor del 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 que se reserva 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.
- Capacidad máxima de nodo. Especifica la carga máxima para una instancia de esta aplicación en un solo 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 se superan:
NodeReservationCapacity no debe ser mayor que MaximumNodeCapacity.
Si se especifican el parámetro MinimumNodes y la métrica NodeReservationCapacity, el producto de MinimumNodes y NodeReservationCapacity no debe ser mayor que TotalApplicationCapacity. Para obtener más información, consulte Métricas, carga y capacidad de la aplicación
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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 de este valor es cero, lo que significa que no hay ninguna capacidad reservada para la aplicación.
Propiedades de parámetro
| Tipo: | Int64 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TimeoutSec
Especifica el período de tiempo de espera, en segundos, para la operación.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.