Compartilhar via

New-ServiceFabricApplication

  • Referência
Módulo:
ServiceFabric

Cria um aplicativo do Service Fabric.

Sintaxe

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

O cmdlet New-ServiceFabricApplication cria um aplicativo do Service Fabric de um tipo de aplicativo registrado. Use o cmdlet Register-ServiceFabricApplicationType para registrar um tipo de aplicativo.

Antes de executar qualquer operação em um cluster do Service Fabric, estabeleça uma conexão com o cluster usando o cmdlet Connect-ServiceFabricCluster.

Exemplos

Exemplo 1: Criar um aplicativo

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

Esse comando cria um aplicativo do tipo PersistentToDoListApp. O aplicativo é a versão 1.0. O tipo de aplicativo e a versão vêm do manifesto do aplicativo no pacote do aplicativo que foi usado ao registrar o aplicativo usando cmdlet Register-ServiceFabricApplicationType.

Exemplo 2: criar um aplicativo substituindo valores de parâmetro padrão no manifesto do aplicativo

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

Esse comando cria um aplicativo do tipo PersistentToDoListApp e versão 1.0 com valores substituídos para os parâmetros CustomParameter1 e CustomParameter2. Esses nomes de parâmetro devem existir no manifesto do aplicativo do pacote do aplicativo que foi usado ao registrar o aplicativo usando cmdlet Register-ServiceFabricApplicationType.

Parâmetros

-ApplicationName

Especifica o URI (Uniform Resource Identifier) de um aplicativo do Service Fabric. O cmdlet cria um aplicativo do Service Fabric com o nome que você especificar.

Tipo:Uri
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationParameter

Especifica as substituições para parâmetros de aplicativo definidos no manifesto do aplicativo como pares chave/valor. O cmdlet cria um aplicativo do Service Fabric do tipo de aplicativo e usa os valores substituídos para esses parâmetros. Os parâmetros que estão sendo substituídos aqui devem existir no manifesto do aplicativo.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationTypeName

Especifica o nome de um tipo de aplicativo do Service Fabric. O cmdlet cria um aplicativo do Service Fabric do tipo de aplicativo que você especificar.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApplicationTypeVersion

Especifica a versão de um tipo de aplicativo do Service Fabric. O cmdlet cria um aplicativo que tem a versão especificada.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaximumNodes

Especifica o número máximo de nós nos quais colocar um aplicativo. O valor desse parâmetro deve ser um inteiro não negativo. O valor padrão é 0, o que indica que o aplicativo pode ser colocado em qualquer número de nós no cluster.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Metrics

Especifica uma matriz de métricas. Essas métricas são usadas pelo Gerenciador de Recursos de Cluster do Service Fabric para gerenciar recursos no cluster. Para obter mais informações sobre métricas e gerenciamento de recursos no Service Fabric, consulte de Introdução do Gerenciador de Recursos de Cluster do Service Fabric. Cada métrica pode seguir o padrão MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity ou pode especificar MetricName e usar nomes de parâmetro NodeReservationCapacity, MaximumNodeCapacityou TotalApplicationCapacity seguido por um valor de parâmetro e separado por dois-pontos. Cada parâmetro name:value par pode aparecer no máximo uma vez.

  • MetricName. Especifica o nome da métrica.
  • NodeReservationCapacity. Especifica a quantidade de carga de métrica reservada em nós que têm instâncias desse aplicativo. Se MinimumNodes for especificado, o produto desses valores será a capacidade reservada no cluster para o aplicativo.
  • MaximumNodeCapacity. Especifica a carga máxima para uma instância deste aplicativo em um único nó. Mesmo que a capacidade do nó seja maior que esse valor, o Service Fabric limitará a carga total das réplicas filho do aplicativo a esse valor.
  • TotalApplicationCapacity. Especifica a capacidade total do aplicativo no cluster. O Service Fabric tenta limitar a soma das cargas das réplicas filho do aplicativo a esse valor.

Ao criar o aplicativo, o Service Fabric executará as seguintes validações e falhará no comando se eles não passarem:

  • NodeReservationCapacity não deve ser maior que MaximumNodeCapacity.

  • Se o parâmetro MinimumNodes e a métrica NodeReservationCapacity forem especificados, o produto de MinimumNodes e NodeReservationCapacity não deverá ser maior que TotalApplicationCapacity. Para obter mais informações, consulte Métricas de Aplicativo, Carga e Capacidade

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MinimumNodes

Especifica o número mínimo de nós em que o Service Fabric reservará capacidade para este aplicativo, isso não significa que o aplicativo tenha réplicas em todos esses nós. O valor desse parâmetro deve ser um inteiro não negativo. O valor padrão para isso é zero, o que significa que nenhuma capacidade é reservada para o aplicativo.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeoutSec

Especifica o período de tempo limite, em segundos, para a operação.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object