Ler em inglês

Compartilhar via

Set-AzVMSqlServerExtension

  • Referência
Módulo:
Az.Compute

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

Sintaxe

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

Description

O cmdlet Set-AzVMSqlServerExtension 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

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

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

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

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

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

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

PowerShell 
PS C:\> Get-AzVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzVMSqlServerExtension -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

PowerShell 
PS C:\> Get-AzVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzVMSqlServerExtension -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

None

Esse cmdlet não aceita nenhuma entrada.

Saídas