New-ServiceFabricApplication
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