Compartir a través de

Set-AzureSqlDatabase

  • Referencia
Módulo:
Azure

Establece las propiedades de una instancia de Azure SQL Database.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureSqlDatabase
   -ServerName <String>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureSqlDatabase
   -ServerName <String>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzureSqlDatabase establece las propiedades de una instancia de Azure SQL Database. Puede especificar la base de datos por nombre o pasar un objeto de Azure SQL Database a través de la canalización. Puede especificar el servidor por nombre o pasar un contexto de conexión de servidor de Azure SQL Database. Cree un contexto de conexión mediante la ejecución del cmdlet New-AzureSqlDatabaseServerContext . Si especifica el servidor por nombre, el cmdlet usa la información actual de la suscripción de Azure para autenticar la solicitud.

Ejemplos

Ejemplo 1: Cambiar el tamaño de una base de datos mediante un contexto de conexión

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20

En este ejemplo se cambia el tamaño de la base de datos denominada Database01 a 20 GB, en el contexto de conexión del servidor de Azure SQL Database $Context.

Ejemplo 2: Cambiar el tamaño de una base de datos mediante un nombre de servidor

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20

En este ejemplo se cambia el tamaño de la base de datos denominada Database01 a 20 GB en el servidor denominado lpqd0zbr8y.

Parámetros

-Confirm

Le solicita su 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

-ConnectionContext

Especifica el contexto de conexión de un servidor.

Tipo:IServerDataServiceContext
Alias:Context
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Database

Especifica un objeto que representa la instancia de Azure SQL Database que modifica este cmdlet.

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

-DatabaseName

Especifica el nombre de la base de datos que modifica este cmdlet.

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

-Edition

Especifica la nueva edición para Azure SQL Database. Los valores válidos son:

  • Ninguno
  • Web
  • Negocio
  • Básico
  • Estándar
  • Premium
Tipo:DatabaseEdition
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Permite que la acción se complete sin solicitar confirmación.

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

-MaxSizeBytes

Especifica el nuevo tamaño máximo para la base de datos en bytes. Puede especificar este parámetro o el parámetro MaxSizeGB . Consulte el parámetro MaxSizeGB para obtener valores aceptables en función de la edición.

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

-MaxSizeGB

Especifica el nuevo tamaño máximo para la base de datos en gigabytes. Puede especificar este parámetro o el parámetro MaxSizeBytes . Los valores aceptables difieren en función de la edición.

Valores básicos de edición: 1 o 2

Valores de Standard Edition: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 o 250

Valores de Premium Edition: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200, 250, 300, 400 o 500

Valores de Web Edition: 1 o 5

Valores de Business Edition: 10, 20, 30, 40, 50, 100 o 150

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

-NewDatabaseName

Especifica el nuevo nombre de la base de datos.

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

-PassThru

Devuelve la instancia actualizada de Azure SQL Database.

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

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

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

-ServerName

Especifica el nombre del servidor que contiene la base de datos que modifica este cmdlet.

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

-ServiceObjective

Especifica un objeto que representa el nuevo objetivo de servicio (nivel de rendimiento) para esta base de datos. Los valores válidos son:

  • Basic: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c
  • Estándar (S0): f1173c43-91bd-4aaa-973c-54e79e15235b
  • Estándar (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928
  • Estándar (S2): 455330e1-00cd-488b-b5fa-177c226f28b7
  • *Estándar (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40
  • Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d
  • Premium (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0
  • Premium (P3): a7c4c615-cfb1-464b-b252-925be0a19446

*Standard (S3) forma parte de la última actualización de SQL Database V12 (versión preliminar). Para más información, consulte Novedades de la versión preliminar de Azure SQL Database V12.https://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

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

-Sync

Tipo:SwitchParameter
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 se ejecutara el cmdlet. 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

Entradas

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

Salidas

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database