Share via


Set-AzVMSqlServerExtension

Legt die Azure SQL Server-Erweiterung auf einem virtuellen Computer fest.

Syntax

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

Beschreibung

Das Cmdlet Set-AzVMSqlServerExtension legt die AzureSQL Server-Erweiterung auf einem virtuellen Computer fest.

Beispiele

Beispiel 1: Festlegen automatischer Patchingeinstellungen auf einem virtuellen Computer

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

Der erste Befehl erstellt ein Konfigurationsobjekt mithilfe des Cmdlets New-AzVMSqlServerAutoPatchingConfig . Der Befehl speichert die Konfiguration in der variablen $AutoPatchingConfig. Der zweite Befehl ruft den virtuellen Computer "VirtualMachine11" in der Ressourcengruppe testrg mithilfe des Cmdlets "Get-AzVM" ab. Der Befehl übergibt dieses Objekt mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet legt die Einstellungen für das automatische Patchen in $AutoPatchingConfig für den virtuellen Computer fest. Der Befehl übergibt den virtuellen Computer an das Update-AzVM-Cmdlet.

Beispiel 2: Festlegen automatischer Sicherungseinstellungen auf einem virtuellen Computer

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

Der erste Befehl erstellt ein Konfigurationsobjekt mithilfe des Cmdlets New-AzVMSqlServerAutoBackupConfig . Der Befehl speichert die Konfiguration in der variablen $AutoBackupConfig. Der zweite Befehl ruft den virtuellen Computer "VirtualMachine11" im Testrg der Ressourcengruppe ab und übergibt ihn dann an das aktuelle Cmdlet. Das aktuelle Cmdlet legt die einstellungen für die automatische Sicherung in $AutoBackupConfig für den virtuellen Computer fest. Der Befehl übergibt den virtuellen Computer an das Update-AzVM-Cmdlet.

Parameter

-AutoBackupSettings

Gibt die automatischen SQL Server-Sicherungseinstellungen an. Verwenden Sie das Cmdlet New-AzVMSqlServerAutoBackupConfig, um ein AutoBackup Einstellungen-Objekt zu erstellen.

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

-AutoPatchingSettings

Gibt die Einstellungen für das automatische SQL Server-Patching an. Verwenden Sie das Cmdlet New-AzVMSqlServerAutoPatchingConfig, um ein AutoPatching Einstellungen-Objekt zu erstellen.

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

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

Gibt den Speicherort des virtuellen Computers an.

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

-Name

Gibt den Namen der SQL Server-Erweiterung an.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-Version

Gibt die Version der SQL Server-Erweiterung an.

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

-VMName

Gibt den Namen des virtuellen Computers an, auf dem dieses Cmdlet die SQL Server-Erweiterung festlegt.

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

Eingaben

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Ausgaben

PSAzureOperationResponse