Gestion de la maintenance planifiée à l’aide de PowerShell

S’applique aux : ✔️ Machines virtuelles Linux ✔️ Machines virtuelles Windows ✔️ Groupes identiques flexibles ✔️ Groupes identiques uniformes

Vous pouvez utiliser Azure PowerShell pour savoir quand la maintenance des machines virtuelles a été planifiée. Les informations de maintenance planifiée sont disponibles à partir de la cmdlet Get-AzVM lorsque vous utilisez le paramètre -status.

Les informations de maintenance sont retournées uniquement en cas de maintenance planifiée. Si aucune maintenance planifiée n’impacte la machine virtuelle, l’applet de commande ne retourne pas d’informations de maintenance.

Get-AzVM -ResourceGroupName myResourceGroup -Name myVM -Status

Sortie

MaintenanceRedeployStatus               : 
  IsCustomerInitiatedMaintenanceAllowed : True
  PreMaintenanceWindowStartTime         : 5/14/2018 12:30:00 PM
  PreMaintenanceWindowEndTime           : 5/19/2018 12:30:00 PM
  MaintenanceWindowStartTime            : 5/21/2018 4:30:00 PM
  MaintenanceWindowEndTime              : 6/4/2018 4:30
  LastOperationResultCode               : None 

Les propriétés suivantes sont retournées sous MaintenanceRedeployStatus :

Valeur Description
IsCustomerInitiatedMaintenanceAllowed Indique si vous pouvez démarrer la maintenance sur la machine virtuelle maintenant
PreMaintenanceWindowStartTime Début de la fenêtre de maintenance en libre-service lorsque vous pouvez lancer la maintenance sur votre machine virtuelle
PreMaintenanceWindowEndTime Fin de la fenêtre de maintenance en libre-service lorsque vous pouvez lancer la maintenance sur votre machine virtuelle
MaintenanceWindowStartTime Début de la maintenance planifiée pendant laquelle Azure lance la maintenance sur votre machine virtuelle
MaintenanceWindowEndTime Fin de la fenêtre de maintenance planifiée pendant laquelle Azure lance la maintenance sur votre machine virtuelle
LastOperationResultCode Résultat de la dernière tentative de lancement de la maintenance sur la machine virtuelle

Vous pouvez également obtenir l'état de maintenance de toutes les machines virtuelles d'un groupe de ressources à l'aide de Get-AzVM sans spécifier de machine virtuelle.

Get-AzVM -ResourceGroupName myResourceGroup -Status

L’exemple PowerShell suivant prend votre ID d’abonnement et retourne la liste des machines virtuelles dont la maintenance est planifiée.


function MaintenanceIterator
{
    Select-AzSubscription -SubscriptionId $args[0]

    $rgList= Get-AzResourceGroup 

    for ($rgIdx=0; $rgIdx -lt $rgList.Length ; $rgIdx++)
    {
        $rg = $rgList[$rgIdx]        
	$vmList = Get-AzVM -ResourceGroupName $rg.ResourceGroupName 
        for ($vmIdx=0; $vmIdx -lt $vmList.Length ; $vmIdx++)
        {
            $vm = $vmList[$vmIdx]
            $vmDetails = Get-AzVM -ResourceGroupName $rg.ResourceGroupName -Name $vm.Name -Status
              if ($vmDetails.MaintenanceRedeployStatus )
            {
                Write-Output "VM: $($vmDetails.Name)  IsCustomerInitiatedMaintenanceAllowed: $($vmDetails.MaintenanceRedeployStatus.IsCustomerInitiatedMaintenanceAllowed) $($vmDetails.MaintenanceRedeployStatus.LastOperationMessage)"               
            }
          }
    }
}

Démarrer la maintenance sur votre machine virtuelle à l’aide de PowerShell

À l’aide des informations de la fonction de la section précédente, la commande suivante démarre la maintenance sur une machine virtuelle si IsCustomerInitiatedMaintenanceAllowed est défini sur true.

Restart-AzVM -PerformMaintenance -name $vm.Name -ResourceGroupName $rg.ResourceGroupName 

Déploiements Classic

Important

Les machines virtuelles créées avec le modèle de déploiement Classic seront supprimées le 1er mars 2023.

Si vous utilisez des ressources IaaS provenant d’Azure Service Management, effectuez la migration avant le 1er mars 2023. Nous vous encourageons à effectuer le basculement plus tôt plus pour tirer parti des nombreuses fonctionnalités améliorées d’Azure Resource Manager.

Pour plus d’informations, consultez Migrez vos ressources IaaS vers Azure Resource Manager avant le 1er mars 2023.

Si vous avez encore des machines virtuelles qui ont été déployées à l’aide du modèle de déploiement Classic, vous pouvez utiliser PowerShell pour interroger ces machines virtuelles et démarrer la maintenance.

Pour obtenir l’état de la maintenance d’une machine virtuelle, tapez :

Get-AzureVM -ServiceName <Service name> -Name <VM name>

Pour démarrer la maintenance sur votre machine virtuelle classique, tapez :

Restart-AzureVM -InitiateMaintenance -ServiceName <service name> -Name <VM name>

Étapes suivantes

Vous pouvez également gérer la maintenance planifiée à l’aide d’Azure CLI ou du portail.