Set-AzureSqlDatabase

Módulo:

Azure

Define propriedades para 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

Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureSqlDatabase
   -ConnectionContext <IServerDataServiceContext>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureSqlDatabase
   -ServerName <String>
   -DatabaseName <String>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureSqlDatabase
   -ServerName <String>
   -Database <Database>
   [-NewDatabaseName <String>]
   [-Edition <DatabaseEdition>]
   [-MaxSizeGB <Int32>]
   [-MaxSizeBytes <Int64>]
   [-ServiceObjective <ServiceObjective>]
   [-PassThru]
   [-Force]
   [-Sync]
   [-Profile <AzureSMProfile>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzureSqlDatabase define propriedades para um Banco de Dados SQL do Azure. Você pode especificar o banco de dados por nome ou passar um objeto do Banco de Dados SQL do Azure pelo pipeline. Você pode especificar o servidor por nome ou passar um contexto de conexão de servidor do Banco de Dados SQL do Azure. Crie um contexto de conexão executando o cmdlet New-AzureSqlDatabaseServerContext . Se você especificar o servidor pelo nome, o cmdlet usará as informações de assinatura atuais do Azure para autenticar a solicitação.

Exemplos

Exemplo 1: Alterar o tamanho de um banco de dados usando um contexto de conexão

PS C:\> $Database01 = Get-AzureSqlDatabase -ConnectionContext $Context -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ConnectionContext $Context -Database $Database01 -MaxSizeGB 20

Este exemplo altera o tamanho do banco de dados chamado Database01 para 20 GB, no contexto de conexão do servidor do Banco de Dados SQL do Azure $Context.

Exemplo 2: Alterar o tamanho de um banco de dados usando um nome de servidor

PS C:\> $Database01 = Get-AzureSqlDatabase -ServerName "lpqd0zbr8y" -DatabaseName "Database01"
PS C:\> Set-AzureSqlDatabase -ServerName "lpqd0zbr8y" -Database $Database01 -MaxSizeGB 20

Este exemplo altera o tamanho do banco de dados chamado Database01 para 20 GB no servidor chamado lpqd0zbr8y.

Parâmetros

-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.

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

-Database

Especifica um objeto que representa o Banco de Dados SQL do Azure que esse cmdlet modifica.

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

-DatabaseName

Especifica o nome do banco de dados que esse cmdlet modifica.

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

-Edition

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

• Nenhum
• Web
• Empresas
• Basic
• Standard
• Premium

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.

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

-MaxSizeBytes

Especifica o novo tamanho máximo para o banco de dados em bytes. Você pode especificar esse parâmetro ou o parâmetro MaxSizeGB . Consulte o 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 novo tamanho máximo para o 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

-NewDatabaseName

Especifica o novo nome do banco de dados.

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

-PassThru

Retorna o Banco de Dados SQL do Azure atualizado.

Type:	SwitchParameter
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 que contém o banco de dados que esse cmdlet modifica.

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. 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 (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 (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

-Sync

Type:	SwitchParameter
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

Entradas

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

Saídas

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

Links Relacionados

• Banco de Dados SQL do Azure
• Operações para Bancos de Dados SQL do Azure
• Atualizar Banco de Dados
• Get-AzureSqlDatabase
• New-AzureSqlDatabase
• Remove-AzureSqlDatabase
• New-AzureSqlDatabaseServerContext