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 do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo 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 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 atuais da assinatura 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ConnectionContext
Especifica o contexto de conexão de um servidor no qual esse cmdlet cria um banco de dados.
| Tipo: | IServerDataServiceContext |
| Aliases: | Context |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DatabaseName
Especifica o nome do novo banco de dados.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Edition
Especifica a edição para o novo Banco de Dados SQL do Azure. Os valores válidos são:
- Nenhuma
- Web
- Negócio
- Básica
- Standard
- Premium
O valor padrão é Web.
| Tipo: | DatabaseEdition |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Force
Permite que a ação seja concluída sem solicitar a confirmação do usuário.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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 Basic Edition: 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
| Tipo: | Int32 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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.
| Tipo: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ServerName
Especifica o nome do servidor do Banco de Dados SQL do Azure para conter o novo banco de dados.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | 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.