New-ServiceFabricApplication
Cria um aplicativo do Service Fabric.
Sintaxe
Default (Predefinição)
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 ligação ao cluster utilizando o cmdlet Connect-ServiceFabricCluster .
Exemplos
Exemplo 1: Criar um aplicativo
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"
Este comando cria um aplicativo do tipo PersistentToDoListApp. O aplicativo é a versão 1.0. O tipo e a versão do aplicativo vêm do manifesto do aplicativo no pacote do aplicativo que foi usado ao registrar o aplicativo usando o 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'}
Este 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 de aplicativo que foi usado ao registrar o aplicativo usando o 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 especificado.
Propriedades dos parâmetros
| Tipo: | Uri |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 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.
Propriedades dos parâmetros
| Tipo: | Hashtable |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 especificado.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-MaximumNodes
Especifica o número máximo de nós nos quais colocar um aplicativo. O valor deste parâmetro deve ser um número 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.
Propriedades dos parâmetros
| Tipo: | Int64 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 Introdução ao Service Fabric Cluster Resource Manager. Cada métrica pode seguir o padrão MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity ou pode especificar MetricName e usar nomes de parâmetros NodeReservationCapacity, MaximumNodeCapacity ou TotalApplicationCapacity seguidos por um valor de parâmetro e separados por dois pontos. Cada parâmetro name:value pair pode aparecer no máximo uma vez.
- MetricName. Especifica o nome da métrica.
- NodeReservationCapacity. Especifica a quantidade de carga métrica reservada em nós que têm instâncias deste 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 limita a carga total das réplicas filhas 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 filhas do aplicativo a esse valor.
Ao criar o aplicativo, o Service Fabric executa as seguintes validações e falhará no comando se elas não passarem:
NodeReservationCapacity não deve ser mais do que MaximumNodeCapacity.
Se o parâmetro MinimumNodes e a métrica NodeReservationCapacity forem especificados, o produto de MinimumNodes e NodeReservationCapacity não deverá ser mais do que TotalApplicationCapacity. Para obter mais informações, consulte Métricas de aplicativos, carga e capacidade
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 a garantia de ter réplicas em todos esses nós. O valor deste parâmetro deve ser um número inteiro não negativo. O valor padrão para isso é zero, o que significa que nenhuma capacidade está reservada para o aplicativo.
Propriedades dos parâmetros
| Tipo: | Int64 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.