Set-AzureRMVMSqlServerExtension
Définit l’extension Azure SQL Server sur une machine virtuelle.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntaxe
Set-AzureRMVMSqlServerExtension
[[-Version] <String>]
[-ResourceGroupName] <String>
[-VMName] <String>
[[-Name] <String>]
[[-AutoPatchingSettings] <AutoPatchingSettings>]
[[-AutoBackupSettings] <AutoBackupSettings>]
[[-KeyVaultCredentialSettings] <KeyVaultCredentialSettings>]
[[-Location] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Set-AzureRmVMSqlServerExtension définit l’extension serveur AzureSQL sur une machine virtuelle.
Exemples
Exemple 1 : Définir les paramètres de mise à jour corrective automatique sur une machine virtuelle
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
La première commande crée un objet de configuration à l’aide de l’applet de commande New-AzureVMSqlServerAutoPatchingConfig . La commande stocke la configuration dans la variable $AutoPatchingConfig. La deuxième commande obtient la machine virtuelle nommée VirtualMachine11 sur le service nommé Service02 à l’aide de l’applet de commande Get-AzureRmVM. La commande transmet cet objet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline. L’applet de commande actuelle définit les paramètres de mise à jour corrective automatique dans $AutoPatchingConfig pour la machine virtuelle. La commande transmet la machine virtuelle à l’applet de commande Update-AzureRmVM.
Exemple 2 : Définir les paramètres de sauvegarde automatique sur une machine virtuelle
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
La première commande crée un objet de configuration à l’aide de l’applet de commande New-AzureVMSqlServerAutoBackupConfig . La commande stocke la configuration dans la variable $AutoBackupConfig. La deuxième commande obtient la machine virtuelle nommée VirtualMachine11 sur le service nommé Service02, puis la transmet à l’applet de commande actuelle. L’applet de commande actuelle définit les paramètres de sauvegarde automatique dans $AutoBackupConfig pour la machine virtuelle. La commande transmet la machine virtuelle à l’applet de commande Update-AzureRmVM.
Exemple 3 : Désactiver une extension SQL Server sur une machine virtuelle
PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Disable
Cette commande obtient une machine virtuelle nommée VirtualMachine08 sur Service03, puis la transmet à l’applet de commande actuelle. La commande désactive l’extension de machine virtuelle SQL Server sur cette machine virtuelle.
Exemple 4 : Désinstaller une extension SQL Server sur une machine virtuelle spécifique
PS C:\> Get-AzureRmVM -ServiceName "Service03" -Name "VirtualMachine08" | Set-AzureRmVMSqlServerExtension -Uninstall
Cette commande obtient une machine virtuelle nommée VirtualMachine08 sur Service03, puis la transmet à l’applet de commande actuelle. La commande désinstalle une extension de machine virtuelle SQL Server sur cette machine virtuelle.
Paramètres
-AutoBackupSettings
Spécifie les paramètres de sauvegarde SQL Server automatiques. Pour créer un objet AutoBackup Paramètres, utilisez l’applet de commande New-AzureVMSqlServerAutoBackupConfig.
Type: | AutoBackupSettings |
Position: | 6 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-AutoPatchingSettings
Spécifie les paramètres de mise à jour corrective SQL Server automatiques. Pour créer un objet AutoPatching Paramètres, utilisez l’applet de commande New-AzureVMSqlServerAutoPatchingConfig.
Type: | AutoPatchingSettings |
Position: | 5 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-KeyVaultCredentialSettings
Type: | KeyVaultCredentialSettings |
Position: | 7 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Location
Spécifie l’emplacement de la machine virtuelle.
Type: | String |
Position: | 8 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Name
Spécifie le nom de l’extension SQL Server.
Type: | String |
Position: | 4 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ResourceGroupName
Spécifie le nom du groupe de ressources de la machine virtuelle.
Type: | String |
Position: | 2 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Version
Spécifie la version de l’extension SQL Server.
Type: | String |
Alias: | HandlerVersion |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-VMName
Spécifie le nom de la machine virtuelle sur laquelle cette applet de commande définit l’extension SQL Server.
Type: | String |
Position: | 3 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |