New-ServiceFabricApplication
Cria um aplicativo do Service Fabric.
Syntax
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 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'}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 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 que você especificar.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metrics
Especifica uma matriz de métricas. Essas métricas são usadas pelo Cluster do Service Fabric Resource Manager para gerenciar recursos no cluster. Para obter mais informações sobre métricas e gerenciamento de recursos no Service Fabric, consulte o Cluster do Service Fabric Resource Manager Introdução. Cada métrica pode seguir o padrão MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity ou pode especificar MetricName e usar nomes de parâmetro NodeReservationCapacity, MaximumNodeCapacity ou TotalApplicationCapacity seguidos por um valor de parâmetro e separados com dois-pontos. Cada par de parâmetros name:value 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 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 desse 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 de 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 elas não forem aprovadas:
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, Carga e Capacidade do Aplicativo
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumNodes
Especifica o número mínimo de nós em que o Service Fabric reservará capacidade para esse aplicativo, isso não significa que o aplicativo tenha a garantia de ter 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.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Especifica o período de tempo limite, em segundos, para a operação.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
None
Saídas
System.Object