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