Compartilhar via

Set-AzureSqlDatabase

  • Referência
Módulo:
Azure

Define as propriedades de 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

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 por meio do 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.

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.

Tipo:IServerDataServiceContext
Aliases:Context
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Database

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

Tipo:Database
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DatabaseName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Edition

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

  • Nenhum
  • Web
  • Negócios
  • Basic
  • Standard
  • Premium
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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxSizeBytes

Especifica o novo tamanho máximo do 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.

Tipo:Int64
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxSizeGB

Especifica o novo 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

-NewDatabaseName

Especifica o novo nome do banco de dados.

Tipo:String
Aliases:NewName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Retorna o Banco de Dados SQL do Azure atualizado.

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

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

-Sync

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

Entradas

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

Saídas

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