Partilhar via

New-ServiceFabricApplication

  • Referência
Módulo:
ServiceFabric

Cria uma aplicação de Tecido de Serviço.

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 uma aplicação de Tecido de Serviço de um tipo de aplicação registada. Utilize o cmdlet Register-ServiceFabricApplicationType para registar um tipo de aplicação.

Antes de efetuar qualquer operação num cluster de tecido de serviço, estabeleça uma ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .

Exemplos

Exemplo 1: Criar uma aplicação

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

Este comando cria uma aplicação do tipo PersistentToDoListApp. A aplicação é a versão 1.0. O tipo e a versão de aplicação provêm do manifesto de aplicação no pacote de aplicações que foi utilizado ao registar a aplicação utilizando o Register-ServiceFabricApplicationType cmdlet.

Exemplo 2: Criar uma aplicação ao sobrepriming valores de parâmetros padrão no manifesto de aplicação

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

Este comando cria uma aplicação do tipo PersistentToDoListApp e versão 1.0 com valores overridden para os parâmetros CustomParameter1 e CustomParameter2. Estes nomes de parâmetros devem existir no manifesto de aplicação do pacote de aplicações que foi utilizado ao registar a aplicação utilizando o Register-ServiceFabricApplicationType cmdlet.

Parâmetros

-ApplicationName

Especifica o Identificador de Recursos Uniforme (URI) de uma aplicação de Tecido de Serviço. O cmdlet cria uma aplicação de Tecido de Serviço com o nome que especifica.

Tipo:Uri
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationParameter

Especifica as sobreposições para os parâmetros de aplicação definidos no manifesto de aplicação como pares chave/valor. O cmdlet cria uma aplicação de Tecido de Serviço do tipo de aplicação e utiliza os valores ultrapassados para estes parâmetros. Os parâmetros que estão a ser ultrapassados aqui devem existir no manifesto de aplicação.

Tipo:Hashtable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationTypeName

Especifica o nome de um tipo de aplicação de Tecido de Serviço. O cmdlet cria uma aplicação de Tecido de Serviço do tipo de aplicação que especifica.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationTypeVersion

Especifica a versão de um tipo de aplicação De Tecido de Serviço. O cmdlet cria uma aplicação que tem a versão que especifica.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaximumNodes

Especifica o número máximo de nós para a realização de uma aplicação. O valor deste parâmetro deve ser um número inteiro não negativo. O valor predefinido é 0, o que indica que a aplicação pode ser colocada em qualquer número de nós no cluster.

Tipo:Int64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Metrics

Especifica uma série de métricas. Estas métricas são utilizadas pelo Service Fabric Cluster Resource Manager para gerir recursos no cluster. Para obter mais informações sobre métricas e gestão de recursos em Tecido de Serviço, consulte Service Fabric Cluster Resource Manager Introdução. Cada métrica pode seguir o padrão MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity, ou pode especificar o Nome Métrico e usar os nomes de parâmetros NodeReservationCapacity, MaximumNodeCapacity, ou TotalApplicationCapacity , seguido de um valor de parâmetro, e separados com um cólon. Cada nome de parâmetro:par de valor pode aparecer no máximo uma vez.

  • Nome métrico. Especifica o nome da métrica.
  • NodeReservationCapacity. Especifica a quantidade de carga métrica reservada em nós que têm instâncias desta aplicação. Se forem especificados Mínimos , o produto destes valores é a capacidade reservada no cluster para a aplicação.
  • Máxima Incapacidade de Não Desus. Especifica a carga máxima para uma instância deste pedido num único nó. Mesmo que a capacidade do nó seja maior do que este valor, o Service Fabric limita a carga total das réplicas infantis da aplicação a este valor.
  • TotalApplicação Capacidade. Especifica a capacidade total para a aplicação no cluster. O Tecido de Serviço tenta limitar a soma das cargas das réplicas infantis da aplicação a este valor.

Ao criar a aplicação, o Service Fabric executa as seguintes validações e falhará o comando se não passar:

  • Não-Conservação A capacidade não deve ser mais do que a Capacidade Máxima DeNode.

  • Se forem especificados tanto o parâmetro MinimumNodes como a métrica nodeReservationCapacity, então o produto de MinimumNodes e NodeReservationCapacity não deve ser mais do que a Capacidade total de Aplicação. Para mais informações, consulte Métricas de Aplicação, Carga e Capacidade

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MinimumNodes

Especifica o número mínimo de nós onde o Service Fabric reservará capacidade para esta aplicação, o que não significa que a aplicação tenha réplicas em todos esses nós. O valor deste parâmetro deve ser um número inteiro não negativo. O valor predefinido para isto é zero, o que significa que nenhuma capacidade é reservada para a aplicação.

Tipo:Int64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TimeoutSec

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

System.Object