New-AzSqlDatabase

Cria um banco de dados ou um banco de dados elástico.

Syntax

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]
   [-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]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzSqlDatabase cria um banco de dados SQL do Azure. Você também pode criar um banco de dados elástico definindo o parâmetro ElasticPoolName como um pool elástico existente.

Exemplos

Exemplo 1: criar um banco de dados em um 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

Esse comando cria um banco de dados chamado Database01 no servidor Server01.

Exemplo 2: criar um banco de dados elástico em um 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

Esse comando cria um banco de dados chamado Database02 no pool elástico chamado ElasticPool01 no servidor Server01.

Exemplo 3: criar um banco de dados vcore em um 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

Esse comando cria um banco de dados vcore chamado Database03 no servidor Server01.

Exemplo 4: criar um banco de dados sem servidor no 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

Esse comando cria um banco de dados sem servidor chamado Database04 no servidor Server01.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AutoPauseDelayInMinutes

O atraso de pausa automática em minutos para banco de dados (somente sem servidor), -1 para recusar

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-BackupStorageRedundancy

A redundância de armazenamento de backup usada para armazenar backups para o Banco de Dados SQL. As opções são: Local, Zona e Geo.

Type:String
Accepted values:Local, Zone, Geo, GeoZone
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CatalogCollation

Especifica o nome da ordenação do catálogo do banco de dados SQL.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollationName

Especifica o nome da ordenação do banco de dados SQL.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ComputeGeneration

A geração de computação a ser atribuída.

Type:String
Aliases:Family
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ComputeModel

O modelo de computação do banco de dados Sql do Azure. Sem servidor ou provisionado

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

Especifica o nome do banco de dados.

Type:String
Aliases:Name
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, conta, locatário e assinatura usadas para comunicação com o azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Edition

Especifica a edição a ser atribuída ao banco de dados. Os valores aceitáveis para esse parâmetro são:

  • Nenhum
  • Basic
  • Standard
  • Premium
  • DataWarehouse
  • Grátis
  • Stretch
  • GeneralPurpose
  • BusinessCritical
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ElasticPoolName

Especifica o nome do pool elástico no qual colocar o banco de dados.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-EnableLedger

Cria um banco de dados do razão, no qual a integridade de todos os dados é protegida pelo recurso razão. Todas as tabelas no banco de dados do razão devem ser tabelas de razão. Observação: o valor dessa propriedade não pode ser alterado após a criação do banco de dados.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Force

Ignorar mensagem de confirmação para executar a ação

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-HighAvailabilityReplicaCount

O número de réplicas secundárias readonly associadas ao banco de dados para o qual as conexões de intenção de aplicativo readonly podem ser roteados. Essa propriedade só é configurável para bancos de dados da edição Hyperscale.

Type:Int32
Aliases:ReadReplicaCount
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LicenseType

O tipo de licença do banco de dados Sql do Azure. Os valores possíveis são:

  • BasePrice – preços com desconto de Benefício Híbrido do Azure (AHB) para proprietários de licenças SQL Server existentes é aplicado. O preço do banco de dados será descontado para proprietários de licenças SQL Server existentes.
  • LicenseIncluded - preços de desconto Benefício Híbrido do Azure (AHB) para proprietários de licenças SQL Server existentes não é aplicado. O preço do banco de dados incluirá um novo SQL Server custos de licença.
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaintenanceConfigurationId

A ID de configuração de manutenção do Banco de Dados SQL.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaxSizeBytes

Especifica o tamanho máximo do banco de dados em bytes.

Type:Int64
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MinimumCapacity

A capacidade mínima que o banco de dados sempre terá alocado, se não estiver em pausa. Somente para bancos de dados Sql do Azure sem servidor.

Type:Double
Aliases:MinVCore, MinCapacity
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ReadScale

Se habilitada, as conexões que têm a intenção do aplicativo definida como readonly na cadeia de conexão podem ser roteadas para uma réplica secundária de leitura. Essa propriedade só é configurável para bancos de dados Premium e Comercialmente Crítico.

Type:DatabaseReadScale
Accepted values:Disabled, Enabled
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RequestedServiceObjectiveName

Especifica o nome do objetivo de serviço a ser atribuído ao banco de dados.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o servidor é atribuído.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SampleName

O nome do esquema de exemplo a ser aplicado ao criar esse banco de dados.

Type:String
Accepted values:AdventureWorksLT
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryType

O tipo secundário do banco de dados se ele for secundário. Os valores válidos são Geo e Named.

Type:String
Accepted values:Named, Geo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

Especifica o nome do servidor que hospeda o banco de dados.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Tags

Especifica um dicionário de pares chave-valor na forma de uma tabela de hash que esse cmdlet associa ao novo banco de dados. Por exemplo: @{key0="value0";key1=$null;key2="value2"}

Type:Hashtable
Aliases:Tag
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-VCore

O número do Vcore para o banco de dados Sql do Azure

Type:Int32
Aliases:Capacity, MaxVCore, MaxCapacity
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-ZoneRedundant

A redundância de zona a ser associada ao Banco de Dados Sql do Azure

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Saídas

AzureSqlDatabaseModel