Set-AzVMSqlServerExtension

  • Referência
Módulo:
Az.Compute

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

Syntax

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 AzureSQL Server em uma máquina virtual.

Exemplos

Exemplo 1: Definir configurações automáticas de aplicação de patches 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 testrg do Grupo de Recursos 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 correção 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 testrg do Grupo de Recursos e 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.

Type:AutoBackupSettings
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AutoPatchingSettings

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

Type:AutoPatchingSettings
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultCredentialSettings

Type:KeyVaultCredentialSettings
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Especifica o local da máquina virtual.

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome da extensão do SQL Server.

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

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

Type:String
Aliases:HandlerVersion
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Saídas

PSAzureOperationResponse