New-AzureSqlDatabase
Cria um Banco de Dados SQL do Azure.
Observação
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
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 criado usando o cmdlet New-AzureSqlDatabaseServerContext . Ou, se você especificar o nome do servidor, o cmdlet usará as informações de assinatura atuais do Azure para autenticar a solicitação para acessar o 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"
Esse comando cria um Banco de Dados SQL do Azure chamado Database1, para o $Context de contexto de conexão do servidor do Banco de Dados SQL do Azure.
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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ConnectionContext
Especifica o contexto de conexão de um servidor no qual esse cmdlet cria um banco de dados.
Tipo: | IServerDataServiceContext |
Aliases: | Context |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-DatabaseName
Especifica o nome do novo banco de dados.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Edition
Especifica a edição do novo Banco de Dados SQL do Azure. Os valores válidos são:
- Nenhum
- Web
- Negócios
- Basic
- Standard
- Premium
O valor padrão é Web.
Tipo: | DatabaseEdition |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Force
Permite que a ação seja concluída sem solicitar confirmação ao usuário.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Int64 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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 Basic Edition: 1 ou 2
Valores da Standard Edition: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 ou 250
Valores da 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 da Business Edition: 10, 20, 30, 40, 50, 100 ou 150
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
Tipo: | AzureSMProfile |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ServerName
Especifica o nome do servidor do Banco de Dados SQL do Azure para conter o novo banco de dados.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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/.
Tipo: | ServiceObjective |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Saídas
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Observações
- Para excluir um banco de dados criado por New-AzureSqlDatabase, use o cmdlet Remove-AzureSqlDatabase.