Set-AzSqlElasticPool

  • Referência
Módulo:
Az.Sql

Modifica as propriedades de um pool de banco de dados elástico no Banco de Dados SQL do Azure.

Sintaxe

Set-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>]
Set-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 Set-AzSqlElasticPool define propriedades para um pool elástico no Banco de Dados SQL do Azure. Esse cmdlet pode modificar os eDTUs por pool (Dtu), o tamanho máximo de armazenamento por pool (StorageMB), o máximo de eDTUs por banco de dados (DatabaseDtuMax) e o mínimo de eDTUs por banco de dados (DatabaseDtuMin). 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 de 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 pool de tamanho específico em pools elásticos.

Exemplos

Exemplo 1: Modificar propriedades de um pool elástico

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -Dtu 1000 -DatabaseDtuMax 100 -DatabaseDtuMin 20

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               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 204800
Tags              :

Esse comando modifica as propriedades de um pool elástico chamado elasticpool01. O comando define o número de DTUs para o pool elástico como 1000 e define as DTUs mínimas e máximas.

Exemplo 2: Modificar o tamanho máximo de armazenamento de um pool elástico

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -StorageMB 2097152

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           : Premium
Dtu               : 200
DatabaseDtuMax    : 100
DatabaseDtuMin    : 20
StorageMB         : 2097152
Tags              :

Esse comando modifica as propriedades de um pool elástico chamado elasticpool01. O comando define o armazenamento máximo de um pool elástico como 2 TB.

Exemplo 3

Modifica as propriedades de um pool de banco de dados elástico no Banco de Dados SQL do Azure. (gerado automaticamente)

Set-AzSqlElasticPool -Dtu 1000 -Edition 'GeneralPurpose' -ElasticPoolName 'ElasticPool01' -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01'

Exemplo 4: modificar o tipo de enclave preferencial de um pool elástico para VBS

Set-AzSqlElasticPool -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ElasticPoolName "ElasticPool01" -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/26/2015 10:00:17 PM
State                 : Ready
Edition               : Premium
Dtu                   : 200
DatabaseDtuMax        : 100
DatabaseDtuMin        : 20
StorageMB             : 2097152
PreferredEnclaveType  : VBS
Tags                  :

Esse comando atualiza um pool elástico para configurar o enclave VBS nele

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ComputeGeneration

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

Tipo:String
Aliases:Family
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseDtuMax

Especifica o número máximo de DTUs que qualquer banco de dados individual no pool pode consumir. Para obter detalhes sobre quais valores são válidos, consulte a tabela do pool de tamanho específico em pools elásticos. Os valores padrão para diferentes edições são os seguintes:

  • Básico. 5 DTUs
  • Standard. 100 DTUs
  • Premium. 125 DTUs
Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseDtuMin

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseVCoreMax

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

Tipo:Double
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseVCoreMin

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

Tipo:Double
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Dtu

Especifica o número total de DTUs compartilhadas para o pool elástico. Para obter detalhes sobre quais valores são válidos, consulte a tabela do pool de tamanho específico em pools elásticos. Os valores padrão para diferentes edições são os seguintes:

  • Básico. 100 DTUs
  • Standard. 100 DTUs
  • Premium. 125 DTUs
Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Edition

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

  • Nenhum
  • Basic
  • Standard
  • Premium
  • Armazém de dados
  • Gratuita
  • Stretch
  • GeneralPurpose
  • Comercialmente Crítico
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ElasticPoolName

Especifica o nome do pool elástico.

Tipo:String
Aliases:Name
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HighAvailabilityReplicaCount

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LicenseType

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaintenanceConfigurationId

A ID de configuração de manutenção para o Pool Elástico do SQL.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreferredEnclaveType

O tipo de enclave preferencial para o Pool Elástico de SQL do Azure. Os valores possíveis são Padrão e VBS.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o pool elástico é atribuído.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ServerName

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

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-StorageMB

Especifica o limite de armazenamento, em megabytes, para o pool elástico. Para obter mais informações, consulte o cmdlet New-AzSqlElasticPool.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tags

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

Tipo:Hashtable
Aliases:Tag
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VCore

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ZoneRedundant

A redundância de zona a ser associada ao Pool Elástico do Azure Sql

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Saídas

AzureSqlElasticPoolModel