Leer en inglés

Compartir a través de

Set-AzSqlElasticPool

  • Referencia
Módulo:
Az.Sql

Modifica las propiedades de un grupo de bases de datos elásticas en Azure SQL Database.

Sintaxis

PowerShell 
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>]
PowerShell 
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

El cmdlet Set-AzSqlElasticPool establece las propiedades de un grupo elástico en Azure SQL Database. Este cmdlet puede modificar las eDTU por grupo (Dtu), el tamaño máximo de almacenamiento por grupo (StorageMB), el número máximo de eDTU por base de datos (DatabaseDtuMax) y los eDTU mínimos por base de datos (DatabaseDtuMin). Varios parámetros (-Dtu, -DatabaseDtuMin y -DatabaseDtuMax) requieren que el valor que se establezca sea de la lista de valores válidos para ese parámetro. Por ejemplo, -DatabaseDtuMax para un grupo de eDTU estándar de 100 solo se puede establecer en 10, 20, 50 o 100. Para obtener más información sobre qué valores son válidos, consulte la tabla del grupo de tamaño específico en grupos elásticos.

Ejemplos

Ejemplo 1: Modificación de las propiedades de un grupo elástico

PowerShell 
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 las propiedades de un grupo elástico denominado elasticpool01. El comando establece el número de DTU para el grupo elástico en 1000 y establece las DTU mínimas y máximas.

Ejemplo 2: Modificación del tamaño máximo de almacenamiento de un grupo elástico

PowerShell 
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 las propiedades de un grupo elástico denominado elasticpool01. El comando establece el almacenamiento máximo para un grupo elástico en 2 TB.

Ejemplo 3

Modifica las propiedades de un grupo de bases de datos elásticas en Azure SQL Database. (generado automáticamente)

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

Ejemplo 4: Modificación del tipo de enclave preferido de un grupo elástico a VBS

PowerShell 
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 actualiza un grupo elástico para configurar el enclave de VBS en él.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ComputeGeneration

Generación de proceso que se va a asignar.

Tipo:String
Alias:Family
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseDtuMax

Especifica el número máximo de DTU que puede consumir cualquier base de datos única del grupo. Para obtener más información sobre qué valores son válidos, consulte la tabla del grupo de tamaño específico en grupos elásticos. Los valores predeterminados para diferentes ediciones son los siguientes:

  • Básico. 5 DTU
  • Estándar. 100 DTU
  • Prima. 125 DTU
Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseDtuMin

Especifica el número mínimo de DTU que garantiza el grupo elástico para todas las bases de datos del grupo. Para obtener más información sobre qué valores son válidos, consulte la tabla del grupo de tamaño específico en grupos elásticos. El valor predeterminado es cero (0).

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseVCoreMax

Número máximo de núcleo virtual que cualquier base de datos sqlAzure puede consumir en el grupo.

Tipo:Double
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatabaseVCoreMin

El número mínimo de núcleo virtual que pueda consumir sqlAzure Database en el grupo.

Tipo:Double
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Dtu

Especifica el número total de DTU compartidas para el grupo elástico. Para obtener más información sobre qué valores son válidos, consulte la tabla del grupo de tamaño específico en grupos elásticos. Los valores predeterminados para diferentes ediciones son los siguientes:

  • Básico. 100 DTU
  • Estándar. 100 DTU
  • Prima. 125 DTU
Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Edition

Especifica la edición de Azure SQL Database para el grupo elástico. No se puede cambiar la edición. Los valores aceptables para este parámetro son:

  • Ninguno
  • Básico
  • Estándar
  • Prima
  • DataWarehouse
  • Gratis
  • Elasticidad
  • GeneralPurpose
  • BusinessCritical
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ElasticPoolName

Especifica el nombre del grupo elástico.

Tipo:String
Alias:Name
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-HighAvailabilityReplicaCount

Número total de réplicas de alta disponibilidad asociadas al grupo elástico.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LicenseType

Tipo de licencia para la base de datos de Azure Sql.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaintenanceConfigurationId

Identificador de configuración de mantenimiento para el grupo elástico de SQL.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PreferredEnclaveType

Tipo de enclave preferido para el grupo elástico de Azure SQL. Los valores posibles son Default y VBS.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Especifica el nombre del grupo de recursos al que se asigna el grupo elástico.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ServerName

Especifica el nombre del servidor que hospeda el grupo elástico.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageMB

Especifica el límite de almacenamiento, en megabytes, para el grupo elástico. Para más información, consulte el cmdlet New-AzSqlElasticPool.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Tags

Especifica un diccionario de pares clave-valor que este cmdlet asocia al grupo elástico en forma de una tabla hash. Por ejemplo: @{key0="value0";"key 1"=$null;key2="value2"}

Tipo:Hashtable
Alias:Tag
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VCore

Número total compartido de núcleo virtual para el grupo elástico de Sql Azure.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ZoneRedundant

Redundancia de zona que se va a asociar al grupo elástico de Azure Sql

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Salidas