Compartilhar via


Set-AzVMSqlServerExtension

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

Sintaxe

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

$AutoPatchingConfig = New-AzVMSqlServerAutoPatchingConfig -Enable -DayOfWeek "Thursday" -MaintenanceWindowStartingHour 11 -MaintenanceWindowDuration 120 -PatchCategory "Important"
Get-AzVM -ResourceGroupName "testrg" -Name "VirtualMachine11" | Set-AzVMSqlServerExtension -AutoPatchingSettings $AutoPatchingConfig | Update-AzVM

O primeiro comando cria um objeto de configuração usando o cmdlet New-AzVMSqlServerAutoPatchingConfig . O comando armazena a configuração na variável $AutoPatchingConfig. O segundo comando obtém a máquina virtual chamada VirtualMachine11 no Grupo de Recursos testrg 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

$AutoBackupConfig = New-AzVMSqlServerAutoBackupConfig -Enable -RetentionPeriodInDays 10 -StorageUri $StorageUrl -StorageKey $StorageAccountKeySecure
Get-AzVM -ResourceGroupName "testrg" -Name "VirtualMachine11" | Set-AzVMSqlServerExtension -AutoBackupSettings $AutoBackupConfig | Update-AzVM

O primeiro comando cria um objeto de configuração usando o cmdlet New-AzVMSqlServerAutoBackupConfig . O comando armazena a configuração na variável $AutoBackupConfig. O segundo comando obtém a máquina virtual chamada VirtualMachine11 no Grupo de Recursos testrg 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.

Parâmetros

-AutoBackupSettings

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

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

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:AzContext, 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