New-AzureSqlDatabase
Cria um Banco de Dados SQL do Azure.
Observação
Os cmdlets referenciados 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, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.
O módulo do Az PowerShell é o módulo recomendado do PowerShell 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 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 atuais da assinatura 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 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 de Banco de Dados SQL do Azure especificado chamado lpqd0zbr8y. O cmdlet usa as informações atuais da assinatura do Azure para autenticar a solicitação de acesso ao servidor.
Parâmetros
-Collation
Especifica uma ordenação 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 em que 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 a confirmação do 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 Edição Básica: 1 ou 2
Valores da Standard Edition: 1, 2, 5, 10, 20, 30, 40, 50, 100, 150, 200 ou 250
Valores da Edição Premium: 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
| 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 do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o 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 Prêmio (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d Premium (P1): 7203483a-c4fb-4304-9e9f-17c71c904f5d Prêmio (P2): a7d1b92d-c987-4375-b54d-2b1d0e0f5bb0 Prêmio (P3): a7c4c615-cfb1-464b-b252-925be0a19446
*Standard (S3) faz parte da Atualização mais recente do Banco de Dados SQL V12 (versão prévia). Para obter mais informações, consulte Novidades na versão prévia do Banco de Dados SQL do Azure V12https://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.