Partilhar via

Set-AzureSqlDatabase

  • Referência
Módulo:
Azure

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

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

Tipo:IServerDataServiceContext
Aliases:Context
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Database

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

Tipo:Database
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DatabaseName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Edition

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

  • Nenhuma
  • Web
  • Negócio
  • Básica
  • Standard
  • Premium
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.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:Int64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 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

-NewDatabaseName

Especifica o novo nome do banco de dados.

Tipo:String
Aliases:NewName
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Retorna o Banco de Dados SQL do Azure atualizado.

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

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

-Sync

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

Entradas

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

Saídas

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