Freigeben über


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 Set-AzVMSqlServerExtension Cmdlet 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 Cmdlet Update-AzVM.

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

Parameter

-AutoBackupSettings

Gibt die automatischen SQL Server-Sicherungseinstellungen an. Verwenden Sie das cmdlet New-AzVMSqlServerAutoBackupConfig, 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-AzVMSqlServerAutoPatchingConfig, 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:AzContext, 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