Partilhar via


New-AzureSqlDatabase

Cria um Banco de Dados SQL do Azure.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.

Syntax

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

O cmdlet New-AzureSqlDatabase cria um Banco de Dados SQL do Azure. Você pode especificar o servidor usando um contexto de conexão de servidor do Banco de Dados SQL do Azure que você cria usando o cmdlet New-AzureSqlDatabaseServerContext . Ou, se você especificar o nome do servidor, o cmdlet usará as informações atuais da assinatura do Azure para autenticar a solicitação de acesso ao servidor.

Quando você cria um novo banco de dados especificando um servidor do Banco de Dados SQL do Azure, o cmdlet New-AzureSqlDatabase cria um contexto de conexão temporário usando o nome do servidor especificado e as informações de assinatura atuais do Azure para executar a operação.

Exemplos

Exemplo 1: Criar um banco de dados

PS C:\> $Database01 = New-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

Este comando cria um Banco de Dados SQL do Azure chamado Database1, para o contexto de conexão do servidor do Banco de Dados SQL do Azure $Context.

Exemplo 2: Criar um banco de dados na assinatura atual

PS C:\> $Database01 = New-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01" -Edition "Business" -MaxSizeGB 50 -Collation "SQL_Latin1_General_CP1_CI_AS"

Este exemplo cria um banco de dados chamado Database1, no servidor especificado do Banco de dados SQL do Azure chamado lpqd0zbr8y. O cmdlet usa as informações de assinatura atuais do Azure para autenticar a solicitação de acesso ao servidor.

Parâmetros

-Collation

Especifica um agrupamento para o novo banco de dados.

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

-Confirm

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

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

-ConnectionContext

Especifica o contexto de conexão de um servidor onde esse cmdlet cria um banco de dados.

Type:IServerDataServiceContext
Aliases:Context
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

Especifica o nome do novo banco de dados.

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

-Edition

Especifica a edição para o novo Banco de Dados SQL do Azure. Os valores válidos são:

  • None
  • Web
  • Negócio
  • Básica
  • Standard
  • Premium

O valor padrão é Web.

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

-Force

Permite que a ação seja concluída sem solicitar a confirmação do usuário.

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

-MaxSizeBytes

Especifica o tamanho máximo do banco de dados em bytes. Você pode especificar esse parâmetro ou o parâmetro MaxSizeGB . Consulte a descrição do parâmetro MaxSizeGB para obter valores aceitáveis com base na edição.

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

-MaxSizeGB

Especifica o tamanho máximo do banco de dados em gigabytes. Você pode especificar esse parâmetro ou o parâmetro MaxSizeBytes . Os valores aceitáveis diferem com base na edição.

Valores da Edição Básica: 1 ou 2

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

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

Valores da Web Edition: 1 ou 5

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

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

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

-ServerName

Especifica o nome do servidor do Banco de Dados SQL do Azure para conter o novo banco de dados.

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

-ServiceObjective

Especifica um objeto que representa o novo objetivo de serviço (nível de desempenho) para esse banco de dados. Esse valor representa o nível de recursos atribuídos a esse banco de dados. Os valores válidos são:

Básico: dd6d99bb-f193-4ec1-86f2-43d3bccbc49c Padrão (S0): f1173c43-91bd-4aaa-973c-54e79e15235b Padrão (S1): 1b1ebd4d-d903-4baa-97f9-4ea675f5e928 Padrão (S2): 455330e1-00cd-488b-b5fa-177c226f28b7 *Padrão (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) faz parte da atualização mais recente do Banco de dados SQL V12 (visualização). Para obter mais informações, consulte O que há de novo no Azure SQL Database V12 Previewhttps://azure.microsoft.com/documentation/articles/sql-database-preview-whats-new/.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Saídas

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

Notas

  • Para excluir um banco de dados que foi criado por New-AzureSqlDatabase, use o cmdlet Remove-AzureSqlDatabase.