New-AzureSqlDatabase
Crea 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
New-AzureSqlDatabase
-ConnectionContext <IServerDataServiceContext>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzureSqlDatabase
-ServerName <String>
-DatabaseName <String>
[-Collation <String>]
[-Edition <DatabaseEdition>]
[-ServiceObjective <ServiceObjective>]
[-MaxSizeGB <Int32>]
[-MaxSizeBytes <Int64>]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet New-AzureSqlDatabase crea una instancia de Azure SQL Database. Puede especificar el servidor mediante un contexto de conexión del servidor de Azure SQL Database que cree mediante el cmdlet New-AzureSqlDatabaseServerContext . O bien, si especifica el nombre del servidor, el cmdlet usa la información actual de la suscripción de Azure para autenticar la solicitud para acceder al servidor.
Al crear una nueva base de datos especificando un servidor de Azure SQL Database, el cmdlet New-AzureSqlDatabase crea un contexto de conexión temporal mediante el nombre de servidor especificado y la información de suscripción de Azure actual para realizar la operación.
Ejemplos
Ejemplo 1: Creación de una base de datos
PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"Este comando crea una instancia de Azure SQL Database denominada Database1 para el contexto de conexión del servidor de Azure SQL Database $Context.
Ejemplo 2: Creación de una base de datos en la suscripción actual
PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"En este ejemplo se crea una base de datos denominada Database1, en el servidor de Azure SQL Database especificado denominado lpqd0zbr8y. El cmdlet usa la información actual de la suscripción de Azure para autenticar la solicitud para acceder al servidor.
Parámetros
-Collation
Especifica una intercalación para la nueva base de datos.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-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 donde este cmdlet crea una base de datos.
| Tipo: | IServerDataServiceContext |
| Alias: | Context |
| 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 nueva base de datos.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Edition
Especifica la edición para la nueva instancia de Azure SQL Database. Los valores válidos son:
- Ninguno
- Web
- Negocio
- Básico
- Estándar
- Premium
El valor predeterminado es Web.
| 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 pedir confirmación al usuario.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MaxSizeBytes
Especifica el tamaño máximo de la base de datos en bytes. Puede especificar este parámetro o el parámetro MaxSizeGB . Consulte la descripción del parámetro MaxSizeGB para obtener valores aceptables basados en 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 tamaño máximo de 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 |
-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 de Azure SQL Database que va a contener la nueva base de datos.
| 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. Este valor representa el nivel de recursos asignados a esta base de datos. Los valores válidos son:
Basic: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c Standard (S0): f1173c43-91bd-4aaa-973c-54e79e15235b Standard (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928 Standard (S2): 455330e1-00cd-488b-b5fa-177c226f28b7 *Standard (S3): 789681b8-ca10-4eb0-bdf2-e0b050601b40 Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d 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 |
-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 |
Salidas
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Notas
- Para eliminar una base de datos creada por New-AzureSqlDatabase, use el cmdlet Remove-AzureSqlDatabase.