Freigeben über

Set-AzureRMVMSqlServerExtension

  • Referenz
Modul:
AzureRM.Compute

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

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

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

Beispiele

Beispiel 1: Festlegen automatischer Patchingeinstellungen auf einem virtuellen Computer

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

Der erste Befehl erstellt ein Konfigurationsobjekt mithilfe des Cmdlets New-AzureVMSqlServerAutoPatchingConfig . Der Befehl speichert die Konfiguration in der variablen $AutoPatchingConfig. Der zweite Befehl ruft den virtuellen Computer mit dem Namen VirtualMachine11 für den Dienst "Service02" mithilfe des Cmdlets "Get-AzureRmVM" 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 Cmdlet Update-AzureRmVM.

Beispiel 2: Festlegen automatischer Sicherungseinstellungen auf einem virtuellen Computer

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

Der erste Befehl erstellt ein Konfigurationsobjekt mithilfe des Cmdlets New-AzureVMSqlServerAutoBackupConfig . Der Befehl speichert die Konfiguration in der variablen $AutoBackupConfig. Der zweite Befehl ruft den virtuellen Computer "VirtualMachine11" für den Dienst "Service02" 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 Cmdlet Update-AzureRmVM.

Beispiel 3: Deaktivieren einer SQL Server-Erweiterung auf einem virtuellen Computer

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

Dieser Befehl ruft einen virtuellen Computer namens VirtualMachine08 auf Service03 ab und übergibt ihn dann an das aktuelle Cmdlet. Mit dem Befehl wird die Erweiterung des virtuellen SQL Server-Computers auf diesem virtuellen Computer deaktiviert.

Beispiel 4: Deinstallieren einer SQL Server-Erweiterung auf einem bestimmten virtuellen Computer

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

Dieser Befehl ruft einen virtuellen Computer namens VirtualMachine08 auf Service03 ab und übergibt ihn dann an das aktuelle Cmdlet. Der Befehl deinstalliert eine Erweiterung des virtuellen SQL Server-Computers auf diesem virtuellen Computer.

Parameter

-AutoBackupSettings

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

Typ:AutoBackupSettings
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AutoPatchingSettings

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

Typ:AutoPatchingSettings
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultCredentialSettings

Typ:KeyVaultCredentialSettings
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Location

Gibt den Speicherort des virtuellen Computers an.

Typ:String
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der SQL Server-Erweiterung an.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Version

Gibt die Version der SQL Server-Erweiterung an.

Typ:String
Aliase:HandlerVersion
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMName

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

Typ:String
Position:3
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Ausgaben

PSAzureOperationResponse