Set-AzureRMVMSqlServerExtension

  • Riferimento
Modulo:
AzureRM.Compute

Imposta l'estensione SQL Server di Azure in una macchina virtuale.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Il cmdlet Set-AzureRmVMSqlServerExtension imposta l'estensione del server AzureSQL in una macchina virtuale.

Esempio

Esempio 1: Impostare le impostazioni di applicazione automatica delle patch in una macchina virtuale

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

Il primo comando crea un oggetto di configurazione usando il cmdlet New-AzureVMSqlServerAutoPatchingConfig . Il comando archivia la configurazione nella variabile $AutoPatchingConfig. Il secondo comando ottiene la macchina virtuale denominata VirtualMachine11 nel servizio denominato Service02 usando il cmdlet Get-AzureRmVM. Il comando passa l'oggetto al cmdlet corrente usando l'operatore pipeline. Il cmdlet corrente imposta le impostazioni di applicazione automatica delle patch in $AutoPatchingConfig per la macchina virtuale. Il comando passa la macchina virtuale al cmdlet Update-AzureRmVM.

Esempio 2: Impostare le impostazioni di backup automatico in una macchina virtuale

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

Il primo comando crea un oggetto di configurazione usando il cmdlet New-AzureVMSqlServerAutoBackupConfig . Il comando archivia la configurazione nella variabile $AutoBackupConfig. Il secondo comando ottiene la macchina virtuale denominata VirtualMachine11 nel servizio denominato Service02 e quindi la passa al cmdlet corrente. Il cmdlet corrente imposta le impostazioni di backup automatico in $AutoBackupConfig per la macchina virtuale. Il comando passa la macchina virtuale al cmdlet Update-AzureRmVM.

Esempio 3: Disabilitare un'estensione DI SQL Server in una macchina virtuale

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

Questo comando ottiene una macchina virtuale denominata VirtualMachine08 in Service03 e quindi la passa al cmdlet corrente. Il comando disabilita l'estensione macchina virtuale di SQL Server in tale macchina virtuale.

Esempio 4: Disinstallare un'estensione DI SQL Server in una macchina virtuale specifica

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

Questo comando ottiene una macchina virtuale denominata VirtualMachine08 in Service03 e quindi la passa al cmdlet corrente. Il comando disinstalla un'estensione macchina virtuale di SQL Server in tale macchina virtuale.

Parametri

-AutoBackupSettings

Specifica le impostazioni di backup automatiche di SQL Server. Per creare un oggetto AutoBackup Impostazioni , usare il cmdlet New-AzureVMSqlServerAutoBackupConfig.

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

-AutoPatchingSettings

Specifica le impostazioni di applicazione automatica delle patch di SQL Server. Per creare un oggetto AutoPatching Impostazioni , usare il cmdlet New-AzureVMSqlServerAutoPatchingConfig.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Type:IAzureContextContainer
Aliases: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

Specifica il percorso della macchina virtuale.

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

-Name

Specifica il nome dell'estensione DI SQL Server.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse della macchina virtuale.

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

-Version

Specifica la versione dell'estensione SQL Server.

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

-VMName

Specifica il nome della macchina virtuale in cui questo cmdlet imposta l'estensione DI SQL Server.

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

Input

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Output

PSAzureOperationResponse