Delen via

Set-AzureRMVMSqlServerExtension

  • Referentie
Module:
AzureRM.Compute

Hiermee stelt u de Azure SQL Server-extensie in op een virtuele machine.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

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

Description

De cmdlet Set-AzureRmVMSqlServerExtension stelt de AzureSQL Server-extensie in op een virtuele machine.

Voorbeelden

Voorbeeld 1: Instellingen voor automatische patches instellen op een virtuele machine

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

Met de eerste opdracht maakt u een configuratieobject met behulp van de cmdlet New-AzureVMSqlServerAutoPatchingConfig . Met de opdracht wordt de configuratie opgeslagen in de $AutoPatchingConfig variabele. Met de tweede opdracht wordt de virtuele machine met de naam VirtualMachine11 opgehaald op de service met de naam Service02 met behulp van de Get-AzureRmVM-cmdlet. De opdracht geeft dat object door aan de huidige cmdlet met behulp van de pijplijnoperator. Met de huidige cmdlet worden de instellingen voor automatische patches ingesteld in $AutoPatchingConfig voor de virtuele machine. Met de opdracht wordt de virtuele machine doorgegeven aan de cmdlet Update-AzureRmVM.

Voorbeeld 2: Automatische back-upinstellingen instellen op een virtuele machine

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

Met de eerste opdracht maakt u een configuratieobject met behulp van de cmdlet New-AzureVMSqlServerAutoBackupConfig . Met de opdracht wordt de configuratie opgeslagen in de $AutoBackupConfig variabele. Met de tweede opdracht wordt de virtuele machine met de naam VirtualMachine11 op de service Service02 ophaalt en vervolgens doorgegeven aan de huidige cmdlet. Met de huidige cmdlet worden de instellingen voor automatische back-up ingesteld in $AutoBackupConfig voor de virtuele machine. Met de opdracht wordt de virtuele machine doorgegeven aan de cmdlet Update-AzureRmVM.

Voorbeeld 3: Een SQL Server-extensie uitschakelen op een virtuele machine

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

Met deze opdracht wordt een virtuele machine met de naam VirtualMachine08 op Service03 ophaalt en deze vervolgens doorgegeven aan de huidige cmdlet. Met de opdracht wordt de extensie voor virtuele SQL Server-machines op die virtuele machine uitgeschakeld.

Voorbeeld 4: Een SQL Server-extensie verwijderen op een specifieke virtuele machine

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

Met deze opdracht wordt een virtuele machine met de naam VirtualMachine08 op Service03 ophaalt en deze vervolgens doorgegeven aan de huidige cmdlet. Met de opdracht wordt een virtuele SQL Server-machineextensie op die virtuele machine verwijderd.

Parameters

-AutoBackupSettings

Hiermee geeft u de automatische SQL Server-back-upinstellingen. Als u een AutoBackup Instellingen-object wilt maken, gebruikt u de cmdlet New-AzureVMSqlServerAutoBackupConfig.

Type:AutoBackupSettings
Position:6
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-AutoPatchingSettings

Hiermee geeft u de instellingen voor automatische SQL Server-patches op. Als u een AutoPatching Instellingen-object wilt maken, gebruikt u de cmdlet New-AzureVMSqlServerAutoPatchingConfig.

Type:AutoPatchingSettings
Position:5
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultCredentialSettings

Type:KeyVaultCredentialSettings
Position:7
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Hiermee geeft u de locatie van de virtuele machine.

Type:String
Position:8
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de SQL Server de extensie.

Type:String
Position:4
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep van de virtuele machine.

Type:String
Position:2
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

Hiermee geeft u de versie van de SQL Server-extensie.

Type:String
Aliases:HandlerVersion
Position:1
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Hiermee geeft u de naam op van de virtuele machine waarop deze cmdlet de SQL Server-extensie instelt.

Type:String
Position:3
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Uitvoerwaarden

PSAzureOperationResponse