Compartilhar via

Set-AzureRMVMSqlServerExtension

  • Referência
Módulo:
AzureRM.Compute

Define a extensão do SQL Server do Azure em uma máquina virtual.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Set-AzureRMVMSqlServerExtension
   [[-Version] <String>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-Name] <String>]
   [[-AutoPatchingSettings] <AutoPatchingSettings>]
   [[-AutoBackupSettings] <AutoBackupSettings>]
   [[-KeyVaultCredentialSettings] <KeyVaultCredentialSettings>]
   [[-Location] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRmVMSqlServerExtension define a extensão do AzureSQL Server em uma máquina virtual.

Exemplos

Exemplo 1: Definir configurações automáticas de aplicação de patch em uma máquina virtual

PS C:\> $AutoPatchingConfig = New-AzureVMSqlServerAutoPatchingConfig -Enable -DayOfWeek "Thursday" -MaintenanceWindowStartingHour 11 -MaintenanceWindowDuration 120 -PatchCategory "Important"
PS C:\> Get-AzureRmVM -ServiceName "Service02" -Name "VirtualMachine11" | Set-AzureRmVMSqlServerExtension -AutoPatchingSettings $AutoPatchingConfig | Update-AzureRmVM

O primeiro comando cria um objeto de configuração usando o cmdlet New-AzureVMSqlServerAutoPatchingConfig . O comando armazena a configuração na variável $AutoPatchingConfig. O segundo comando obtém a máquina virtual chamada VirtualMachine11 no serviço chamado Service02 usando o cmdlet Get-AzureRmVM. O comando passa esse objeto para o cmdlet atual usando o operador de pipeline. O cmdlet atual define as configurações de aplicação de patch automática em $AutoPatchingConfig para a máquina virtual. O comando passa a máquina virtual para o cmdlet Update-AzureRmVM.

Exemplo 2: Definir configurações de backup automático em uma máquina virtual

PS C:\> $AutoBackupConfig = New-AzureVMSqlServerAutoBackupConfig -Enable -RetentionPeriod 10 -StorageUri $StorageUrl -StorageKey $StorageAccountKeySecure
PS C:\> Get-AzureRmVM -ServiceName "Service02" -Name "VirtualMachine11" | Set-AzureRmVMSqlServerExtension -AutoBackupSettings $AutoBackupConfig | Update-AzureRmVM

O primeiro comando cria um objeto de configuração usando o cmdlet New-AzureVMSqlServerAutoBackupConfig . O comando armazena a configuração na variável $AutoBackupConfig. O segundo comando obtém a máquina virtual chamada VirtualMachine11 no serviço chamado Service02 e, em seguida, a passa para o cmdlet atual. O cmdlet atual define as configurações de backup automático em $AutoBackupConfig para a máquina virtual. O comando passa a máquina virtual para o cmdlet Update-AzureRmVM.

Exemplo 3: Desabilitar uma extensão do SQL Server em uma máquina virtual

PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Disable

Esse comando obtém uma máquina virtual chamada VirtualMachine08 no Service03 e a passa para o cmdlet atual. O comando desabilita a extensão da máquina virtual do SQL Server nessa máquina virtual.

Exemplo 4: Desinstalar uma extensão do SQL Server em uma máquina virtual específica

PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Uninstall

Esse comando obtém uma máquina virtual chamada VirtualMachine08 no Service03 e a passa para o cmdlet atual. O comando desinstala uma extensão de máquina virtual do SQL Server nessa máquina virtual.

Parâmetros

-AutoBackupSettings

Especifica as configurações de backup automático do SQL Server. Para criar um objeto AutoBackupSettings , use o cmdlet New-AzureVMSqlServerAutoBackupConfig.

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

-AutoPatchingSettings

Especifica as configurações automáticas de aplicação de patch do SQL Server. Para criar um objeto AutoPatchingSettings , use o cmdlet New-AzureVMSqlServerAutoPatchingConfig.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-KeyVaultCredentialSettings

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

-Location

Especifica o local da máquina virtual.

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

-Name

Especifica o nome da extensão do SQL Server.

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

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

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

-Version

Especifica a versão da extensão do SQL Server.

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

-VMName

Especifica o nome da máquina virtual na qual esse cmdlet define a extensão do SQL Server.

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

Entradas

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Saídas

PSAzureOperationResponse