Partilhar via

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 as 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 para seu pool de tamanhos específicos 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              :

Este 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              :

Este comando modifica as propriedades de um pool elástico chamado elasticpool01. O comando define o armazenamento máximo para 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 preferido 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                  :

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

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ComputeGeneration

A geração de computação a atribuir.

Tipo:String
Aliases:Family
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DatabaseDtuMax

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

  • Basic. 5 DTUs
  • Standard. 100 DTUs
  • Premium. 125 DTUs
Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 para seu pool de tamanhos específicos em pools elásticos. O valor padrão é zero (0).

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DatabaseVCoreMax

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

Tipo:Double
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DatabaseVCoreMin

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

Tipo:Double
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 para seu pool de tamanhos específicos em pools elásticos. Os valores padrão para diferentes edições são os seguintes:

  • Basic. 100 DTUs
  • Standard. 100 DTUs
  • Premium. 125 DTUs
Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Edition

Especifica a edição do Banco de Dados SQL do Azure para o pool elástico. Não é possível alterar a edição. Os valores aceitáveis para este parâmetro são:

  • Nenhuma
  • Básica
  • Standard
  • Premium
  • Armazém de Dados
  • Gratuito
  • Esticar
  • GeneralPurpose
  • Negócio Crítico
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ElasticPoolName

Especifica o nome do pool elástico.

Tipo:String
Aliases:Name
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-HighAvailabilityReplicaCount

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LicenseType

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaintenanceConfigurationId

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PreferredEnclaveType

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ServerName

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

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tags

Especifica um dicionário de pares chave-valor 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VCore

O número total compartilhado de Vcore para o Sql Azure Elastic Pool.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ZoneRedundant

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

AzureSqlElasticPoolModel