Compartilhar via

New-AzSqlElasticPool

  • Referência
Módulo:
Az.Sql

Cria um pool de banco de dados elástico para um Banco de dados SQL.

Syntax

New-AzSqlElasticPool
   [-ElasticPoolName] <String>
   [-Edition <String>]
   [-Dtu <Int32>]
   [-StorageMB <Int32>]
   [-DatabaseDtuMin <Int32>]
   [-DatabaseDtuMax <Int32>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-MaintenanceConfigurationId <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-PreferredEnclaveType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzSqlElasticPool
   [-ElasticPoolName] <String>
   -Edition <String>
   [-StorageMB <Int32>]
   -VCore <Int32>
   -ComputeGeneration <String>
   [-DatabaseVCoreMin <Double>]
   [-DatabaseVCoreMax <Double>]
   [-Tags <Hashtable>]
   [-ZoneRedundant]
   [-LicenseType <String>]
   [-MaintenanceConfigurationId <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-PreferredEnclaveType <String>]
   [-AsJob]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzSqlElasticPool cria um pool de banco de dados elástico para um Banco de Dados SQL do Azure. Vários parâmetros (-Dtu, -DatabaseDtuMin e -DatabaseDtuMax) exigem que o valor que está sendo definido seja da lista de valores válidos para esse parâmetro. Por exemplo, -DatabaseDtuMax para um pool eDTU Standard 100 só pode ser definido como 10, 20, 50 ou 100. Para obter detalhes sobre quais valores são válidos, consulte a tabela do seu pool de tamanhos específicos em pools elásticos.

Exemplos

Exemplo 1: Criar um pool elástico de DTU

New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "Standard" -Dtu 400 -DatabaseDtuMin 10 -DatabaseDtuMax 100

ResourceId        : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/resourcegroup01/providers/Microsoft.Sql/servers/server01/elasticPools/elasticpool01
ResourceGroupName : resourcegroup01
ServerName        : server01
ElasticPoolName   : elasticpool01
Location          : Central US
CreationDate      : 8/26/2015 10:00:17 PM
State             : Ready
Edition           : Standard
Dtu               : 400
DatabaseDtuMax    : 100
DatabaseDtuMin    : 10
StorageMB         : 409600
Tags              :

Esse comando cria um pool elástico na camada de serviço Standard chamado ElasticPool01. O servidor chamado server01, atribuído a um grupo de recursos do Azure chamado ResourceGroup01, hospeda o pool elástico em. O comando especifica valores de propriedade DTU para o pool e os bancos de dados no pool.

Exemplo 2: Criar um pool elástico vCore

New-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Edition "GeneralPurpose" -vCore 2 -ComputeGeneration Gen5

ResourceId          : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/server01/elasticPools/ElasticPool01
ResourceGroupName   : ResourceGroup01
ServerName          : Server01
ElasticPoolName     : ElasticPool01
Location            : Central US
CreationDate        : 8/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
Tags                :

Esse comando cria um pool elástico na camada de serviço GengeralPurpose chamado ElasticPool01. O servidor chamado server01, atribuído a um grupo de recursos do Azure chamado ResourceGroup01, hospeda o pool elástico em. O comando especifica os valores da propriedade vCore para o pool e os bancos de dados no pool.

Exemplo 3

Cria um pool de banco de dados elástico para um Banco de dados SQL. (gerado automaticamente)

New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -StorageMB 2097152 -VCore 2

Exemplo 4: Cria um pool elástico com o tipo de enclave preferencial como VBS

New-AzSqlElasticPool -ComputeGeneration Gen5 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -VCore 2 -PreferredEnclaveType 'VBS'

ResourceId          : /subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/ResourceGroup01/providers/Microsoft.Sql/servers/server01/elasticPools/ElasticPool01
ResourceGroupName   : ResourceGroup01
ServerName          : Server01
ElasticPoolName     : ElasticPool01
Location            : Central US
CreationDate        : 8/29/2019 2:16:40 AM
State               : Ready
Edition             : GeneralPurpose
SkuName             : GP_Gen5
Dtu                 : 2
DatabaseDtuMax      : 2
DatabaseDtuMin      : 0
Capacity            : 2
DatabaseCapacityMin : 0
DatabaseCapacityMax : 2
Family              : Gen5
MaxSizeBytes        : 34359738368
StorageMB           : 32768
PreferredEnclaveType: VBS
Tags                :

Este comando cria um pool elástico configurado com o enclave VBS

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputeGeneration

A geração de computação a ser atribuída.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor padrão:False
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseDtuMax

Especifica o número máximo de DTUs (Unidades de Taxa de Transferência de Banco de Dados) que qualquer banco de dados no pool pode consumir. Os valores padrão para as diferentes edições são os seguintes:

  • Básico. 5 DTUs
  • Standard. 100 DTUs
  • Premium. 125 DTUs Para obter detalhes sobre quais valores são válidos, consulte a tabela para seu pool de tamanho específico em pools elásticos
Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseDtuMin

Especifica o número mínimo de DTUs que o pool elástico garante a todos os bancos de dados no pool. O valor padrão é zero (0). Para obter detalhes sobre quais valores são válidos, consulte a tabela do seu pool de tamanhos específicos em pools elásticos.

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseVCoreMax

O número VCore máximo que qualquer Banco de Dados SqlAzure pode consumir no pool.

Tipo:Double
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseVCoreMin

O número VCore mínimo que qualquer Banco de Dados SqlAzure pode consumir no pool.

Tipo:Double
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Dtu

Especifica o número total de DTUs compartilhadas para o pool elástico. Os valores padrão para as diferentes edições são os seguintes:

  • Básico. 100 DTUs
  • Standard. 100 DTUs
  • Premium. 125 DTUs Para obter detalhes sobre quais valores são válidos, consulte a tabela do seu pool de tamanho específico em pools elásticos.
Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Edition

Especifica a edição do Banco de Dados SQL do Azure usada para o pool elástico. Os valores aceitáveis para esse parâmetro são:

  • Nenhum
  • Basic
  • Standard
  • Premium
  • DataWarehouse
  • Gratuita
  • Stretch
  • GeneralPurpose
  • Comercialmente Crítico
Tipo:String
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

Especifica o nome do pool elástico que esse cmdlet cria.

Tipo:String
Aliases:Name
Position:2
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-HighAvailabilityReplicaCount

O número total de réplicas de alta disponibilidade associadas ao pool elástico.

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseType

O tipo de licença para o banco de dados SQL do Azure.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-MaintenanceConfigurationId

A ID de configuração de manutenção para o SQL Elastic Pool.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredEnclaveType

O tipo de enclave preferencial para o Azure SQL Elastic Pool. Os valores possíveis são Default e VBS.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual esse cmdlet atribui o pool elástico.

Tipo:String
Position:0
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-ServerName

Especifica o nome do servidor que hospeda o pool elástico.

Tipo:String
Position:1
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageMB

Especifica o limite de armazenamento, em megabytes, para o pool elástico. Se você não especificar esse parâmetro, esse cmdlet calculará um valor que depende do valor do parâmetro Dtu . Consulte os valores possível em limites de armazenamento e eDTU.

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

Especifica um dicionário de pares chave-valor na forma de uma tabela de hash que esse cmdlet associa ao pool elástico. Por exemplo: @{key0="value0"; chave1=$null; key2="valor2"}

Tipo:Hashtable
Aliases:Tag
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-VCore

O número total compartilhado de Vcores para o Pool Elástico do SQL Azure.

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor padrão:False
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneRedundant

A redundância de zona a ser associada ao Azure Sql Elastic Pool

Tipo:SwitchParameter
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Saídas

AzureSqlElasticPoolModel