New-AzSqlDatabase
Crea una base de datos o una base de datos elástica.
Sintaxis
New-AzSqlDatabase
-DatabaseName <String>
[-CollationName <String>]
[-CatalogCollation <String>]
[-MaxSizeBytes <Int64>]
[-Edition <String>]
[-RequestedServiceObjectiveName <String>]
[-ElasticPoolName <String>]
[-ReadScale <DatabaseReadScale>]
[-Tags <Hashtable>]
[-SampleName <String>]
[-ZoneRedundant]
[-AsJob]
[-Force]
[-LicenseType <String>]
[-AutoPauseDelayInMinutes <Int32>]
[-MinimumCapacity <Double>]
[-HighAvailabilityReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-MaintenanceConfigurationId <String>]
[-EnableLedger]
[-PreferredEnclaveType <String>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-UseFreeLimit]
[-FreeLimitExhaustionBehavior <String>]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzSqlDatabase
-DatabaseName <String>
[-CollationName <String>]
[-CatalogCollation <String>]
[-MaxSizeBytes <Int64>]
-Edition <String>
[-ReadScale <DatabaseReadScale>]
[-Tags <Hashtable>]
[-SampleName <String>]
[-ZoneRedundant]
[-AsJob]
[-Force]
-VCore <Int32>
-ComputeGeneration <String>
[-LicenseType <String>]
[-ComputeModel <String>]
[-AutoPauseDelayInMinutes <Int32>]
[-MinimumCapacity <Double>]
[-HighAvailabilityReplicaCount <Int32>]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-MaintenanceConfigurationId <String>]
[-EnableLedger]
[-PreferredEnclaveType <String>]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-UseFreeLimit]
[-FreeLimitExhaustionBehavior <String>]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet New-AzSqlDatabase crea una base de datos de Azure SQL. También puede crear una base de datos elástica estableciendo el parámetro ElasticPoolName en un grupo elástico existente.
Ejemplos
Ejemplo 1: Crear una base de datos en un servidor especificado
New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database01"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : a1e6bd1a-735a-4d48-8b98-afead5ef1218
Edition : Standard
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 268435456000
Status : Online
CreationDate : 7/3/2015 7:33:37 AM
CurrentServiceObjectiveId : f1173c43-91bd-4aaa-973c-54e79e15235b
CurrentServiceObjectiveName : S0
RequestedServiceObjectiveId : f1173c43-91bd-4aaa-973c-54e79e15235b
RequestedServiceObjectiveName :
ElasticPoolName :
EarliestRestoreDate :
LicenseType :
Tags :
EnableLedger : False
Este comando crea una base de datos denominada Database01 en el servidor Server01.
Ejemplo 2: Creación de una base de datos elástica en un servidor especificado
New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database02" -ElasticPoolName "ElasticPool01"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database02
Location : Central US
DatabaseId : 7bd9d561-42a7-484e-bf05-62ddef8015ab
Edition : Standard
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 268435456000
Status : Online
CreationDate : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveId : d1737d22-a8ea-4de7-9bd0-33395d2a7419
CurrentServiceObjectiveName : ElasticPool
RequestedServiceObjectiveId : d1737d22-a8ea-4de7-9bd0-33395d2a7419
RequestedServiceObjectiveName :
ElasticPoolName : ElasticPool01
EarliestRestoreDate :
LicenseType :
Tags :
EnableLedger : False
Este comando crea una base de datos denominada Database02 en el grupo elástico denominado ElasticPool01 en server Server01.
Ejemplo 3: Creación de una base de datos de núcleo virtual en un servidor especificado
New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database03" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen4"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database03
Location : Central US
DatabaseId : 34d9d561-42a7-484e-bf05-62ddef8000ab
Edition : GeneralPurpose
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 268435456000
Status : Online
CreationDate : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveName : GP_Gen4_2
RequestedServiceObjectiveName :
ElasticPoolName :
EarliestRestoreDate :
LicenseType : LicenseIncluded
Tags :
EnableLedger : False
Este comando crea una base de datos de núcleo virtual denominada Database03 en el servidor Server01.
Ejemplo 4: Crear una base de datos sin servidor en el servidor especificado
New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -DatabaseName "Database04" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen5" -ComputeModel Serverless
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database04
Location : Central US
DatabaseId : ef5a9698-012c-4def-8d94-7f6bfb7b4f04
Edition : GeneralPurpose
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 34359738368
Status : Online
CreationDate : 4/12/2019 11:20:29 PM
CurrentServiceObjectiveName : GP_S_Gen5_2
RequestedServiceObjectiveName : GP_S_Gen5_2
ElasticPoolName :
EarliestRestoreDate : 4/12/2019 11:50:29 PM
Tags :
CreateMode :
ReadScale : Disabled
ZoneRedundant : False
Capacity : 2
Family : Gen5
SkuName : GP_S_Gen5
LicenseType : LicenseIncluded
AutoPauseDelayInMinutes : 360
EnableLedger : False
MinimumCapacity : 0.5
Este comando crea una base de datos sin servidor denominada Database04 en el servidor Server01.
Ejemplo 5: Creación de una base de datos configurada con el tipo de enclave preferido como VBS
New-AzSqlDatabase -ResourceGroupName "ResourceGroup01" -DatabaseName "Database01" -ServerName "Server01" -Edition "GeneralPurpose" -Vcore 2 -ComputeGeneration "Gen5" -PreferredEnclaveType "VBS"
ResourceGroupName : ResourceGroup01
ServerName : Server01
DatabaseName : Database01
Location : Central US
DatabaseId : 34d9d561-42a7-484e-bf05-62ddef8000ab
Edition : GeneralPurpose
CollationName : SQL_Latin1_General_CP1_CI_AS
CatalogCollation :
MaxSizeBytes : 268435456000
Status : Online
CreationDate : 8/26/2015 10:04:29 PM
CurrentServiceObjectiveName : GP_Gen5_2
RequestedServiceObjectiveName :
ElasticPoolName :
EarliestRestoreDate :
LicenseType : LicenseIncluded
Tags :
EnableLedger : False
PreferredEnclaveType : VBS
Este comando crea una base de datos configurada con el enclave de VBS.
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 |
-AssignIdentity
Genere y asigne una identidad de Microsoft Entra para esta base de datos para usarla con servicios de administración de claves como Azure KeyVault.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoPauseDelayInMinutes
Retraso de pausa automática en minutos para la base de datos (solo sin servidor), -1 para no participar
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-BackupStorageRedundancy
Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad de SQL Database. Las opciones son: Local, Zone y Geo.
Tipo: | String |
Valores aceptados: | Local, Zone, Geo, GeoZone |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CatalogCollation
Especifica el nombre de la intercalación del catálogo de sql Database.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-CollationName
Especifica el nombre de la intercalación de base de datos SQL.
Tipo: | String |
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: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ComputeModel
Modelo de proceso para Azure Sql Database. Sin servidor o aprovisionado
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 |
-DatabaseName
Especifica el nombre de la base de datos.
Tipo: | String |
Alias: | Name |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
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 |
-Edition
Especifica la edición que se va a asignar a la base de datos. Los valores permitidos para este parámetro son los siguientes:
- Ninguno
- Básico
- Estándar
- Premium
- DataWarehouse
- Gratis
- Stretch
- GeneralPurpose
- BusinessCritical
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ElasticPoolName
Especifica el nombre del grupo elástico en el que se va a colocar la base de datos.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EnableLedger
Crea una base de datos de libro de contabilidad, en la que la característica de libro de contabilidad protege la integridad de todos los datos. Todas las tablas de la base de datos del libro de contabilidad deben ser tablas de libro de contabilidad. Nota: El valor de esta propiedad no se puede cambiar después de crear la base de datos.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptionProtector
Clave del protector de cifrado para SQL Database.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-EncryptionProtectorAutoRotation
Estado de rotación automática de claves de AKV
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-FederatedClientId
Identificador de cliente federado para SQL Database. Se usa para el escenario de CMK entre inquilinos.
Tipo: | Nullable<T>[Guid] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Force
Omitir el mensaje de confirmación para realizar la acción
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-FreeLimitExhaustionBehavior
Comportamiento de agotamiento de la base de datos de límite libre.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-HighAvailabilityReplicaCount
Número de réplicas secundarias de solo lectura asociadas a la base de datos a la que se pueden enrutar las conexiones de intención de aplicación de solo lectura. Esta propiedad solo se puede establecer para las bases de datos de edición de Hiperescala.
Tipo: | Int32 |
Alias: | ReadReplicaCount |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-KeyList
Lista de claves de AKV para SQL Database.
Tipo: | String[] |
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. Los valores posibles son:
- BasePrice: se aplican precios con descuento de Ventaja híbrida de Azure (AHB) para los propietarios de licencias de SQL Server existentes. El precio de la base de datos se descontará para los propietarios de licencias de SQL Server existentes.
- LicenseIncluded: no se aplican precios de descuento de Ventaja híbrida de Azure (AHB) para los propietarios de licencias de SQL Server existentes. El precio de la base de datos incluirá un nuevo costo de licencia de SQL Server.
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 SQL Database.
Tipo: | String |
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.
Tipo: | Int64 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-MinimumCapacity
La capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa. Solo para las bases de datos de Azure Sql sin servidor.
Tipo: | Double |
Alias: | MinVCore, MinCapacity |
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 la base de datos 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 |
-ReadScale
Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura. Esta propiedad solo se puede establecer para las bases de datos Premium y Crítico para la empresa.
Tipo: | DatabaseReadScale |
Valores aceptados: | Disabled, Enabled |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RequestedServiceObjectiveName
Especifica el nombre del objetivo de servicio que se va a asignar a la base de datos.
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 servidor.
Tipo: | String |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-SampleName
Nombre del esquema de ejemplo que se va a aplicar al crear esta base de datos.
Tipo: | String |
Valores aceptados: | AdventureWorksLT |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SecondaryType
El tipo secundario de la base de datos si es secundario. Los valores válidos son Geo y Named.
Tipo: | String |
Valores aceptados: | Named, Geo |
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 hospeda la base de datos.
Tipo: | String |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Tags
Especifica un diccionario de pares clave-valor en forma de tabla hash que este cmdlet asocia a la nueva base de datos. Por ejemplo: @{key0="value0"; key1=$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 |
-UseFreeLimit
Use el límite libre en esta base de datos.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-UserAssignedIdentityId
Lista de identidades asignadas por el usuario para SQL Database.
Tipo: | String[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-VCore
Número de núcleo virtual de la base de datos de Azure Sql
Tipo: | Int32 |
Alias: | Capacity, MaxVCore, MaxCapacity |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
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 |
-ZoneRedundant
Redundancia de zona que se va a asociar a Azure Sql Database
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |