New-AzureSqlDatabase
Cria um Banco de Dados SQL do Azure.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de 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 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionContext
Especifica o contexto de conexão de um servidor no qual 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 do novo Banco de Dados SQL do Azure. Os valores válidos são:
- Nenhum
- Web
- Empresas
- Basic
- 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 confirmação ao 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 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
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 lê. 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
Mostra o que aconteceria se o cmdlet fosse executado. 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
Observações
- Para excluir um banco de dados criado por New-AzureSqlDatabase, use o cmdlet Remove-AzureSqlDatabase.