Partager via

Set-AzureRMVMSqlServerExtension

  • Référence
Module:
AzureRM.Compute

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

Entrées

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Sorties

PSAzureOperationResponse