Compartir a través de

New-ServiceFabricApplication

  • Referencia
Módulo:
ServiceFabric

Crea una aplicación de Service Fabric.

Sintaxis

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.

Tipo:Uri
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Int64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TimeoutSec

Especifica el período de tiempo de espera, en segundos, para la operación.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object