Partager via

Disable-SCVMHost

  • Référence
Module:
VirtualMachineManager

Place un hôte de machine virtuelle en mode maintenance.

Syntax

Disable-SCVMHost
       [-VMHost] <Host>
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]
Disable-SCVMHost
       [-VMHost] <Host>
       [-MoveWithinCluster]
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [<CommonParameters>]

Description

L’applet de commande Disable-SCVMHost place un hôte de machine virtuelle géré par Virtual Machine Manager (VMM) en mode maintenance afin que vous puissiez effectuer des tâches de maintenance sur l’hôte, telles que l’application de mises à jour de sécurité ou le remplacement du matériel.

Vous pouvez utiliser l’applet de commande Disable-SCVMHost pour placer des hôtes Hyper-V individuels, des hôtes VMware ESX ou des hôtes Citrix XenServer en mode maintenance. Vous pouvez également utiliser Disable-SCVMHost pour placer des hôtes en cluster en mode maintenance.

Pour retourner l’hôte au service, utilisez l’applet de commande Enable-SCVMHost.

Pour placer des hôtes Hyper-V en mode maintenance

Si l’hôte appartient à un cluster qui prend en charge la migration dynamique, vous pouvez choisir l’une des méthodes suivantes :

Méthode 1 : Migrer des machines virtuelles hautement disponibles et enregistrer les autres machines virtuelles. Lorsque le paramètre MoveWithinCluster est utilisé avec Disable-SCVMHost, l’applet de commande utilise Live Migration pour migrer toutes les machines virtuelles hautement disponibles en cours d’exécution vers d’autres hôtes du cluster. Il place les machines virtuelles en cours d’exécution qui ne sont pas hautement disponibles dans un état enregistré, ce qui entraîne la perte du service par les utilisateurs. Ensuite, il place l’hôte en mode maintenance.

Méthode 2 : Enregistrez toutes les machines virtuelles. Disable-SCVMHost place toutes les machines virtuelles en cours d’exécution dans un état enregistré, ce qui entraîne la perte du service par les utilisateurs. Ensuite, il place l’hôte en mode maintenance.

Si l’hôte n’appartient pas à un cluster ou s’il appartient à un cluster qui ne prend pas en charge la migration dynamique, Disable-SCVMHost place toutes les machines virtuelles en cours d’exécution dans un état enregistré, ce qui entraîne la perte du service par les utilisateurs. Ensuite, il place l’hôte en mode maintenance.

Fonctionnement de Disable-SCVMHost avec les hôtes VMWare ESX

Lorsque vous placez un hôte ESX en mode maintenance à l’aide de Disable-SCVMHost, VMM envoie une demande d’entrée en mode maintenance au serveur CCenter VMware qui gère cet hôte. Le serveur vCenter place l’hôte ESX en mode maintenance.

Remarque : le comportement système des machines virtuelles sur l’hôte ESX Server est déterminé par la configuration du serveur vCenter. Par exemple, si le planificateur de ressources distribuées VMware n’est pas configuré, vous devrez peut-être arrêter manuellement toutes les machines virtuelles sur l’hôte. Vous devrez peut-être déplacer les machines virtuelles vers un autre hôte pour placer correctement l’hôte ESX Server en mode maintenance.

Pour placer des hôtes XenServer en mode maintenance

Si l’hôte appartient à un cluster qui prend en charge la migration dynamique, vous pouvez choisir l’une des méthodes suivantes :

Méthode 1 : Migrer des machines virtuelles hautement disponibles et enregistrer les autres machines virtuelles. Lorsque le paramètre MoveWithinCluster est utilisé avec Disable-SCVMHost, l’applet de commande utilise XenServer Live Migration pour migrer toutes les machines virtuelles hautement disponibles en cours d’exécution vers d’autres hôtes du cluster. Il place également toutes les machines virtuelles en cours d’exécution qui ne sont pas hautement disponibles dans un état enregistré, ce qui entraîne la perte du service par les utilisateurs. Ensuite, il place l’hôte en mode maintenance.

Méthode 2 : Enregistrez toutes les machines virtuelles. Disable-VMHost place toutes les machines virtuelles en cours d’exécution dans un état enregistré, ce qui entraîne la perte du service par les utilisateurs. Ensuite, il place l’hôte en mode maintenance.

Si l’hôte n’appartient pas à un cluster ou s’il appartient à un cluster qui ne prend pas en charge la migration dynamique, Disable-VMHost place toutes les machines virtuelles en cours d’exécution dans un état enregistré, ce qui entraîne la perte du service par les utilisateurs. Ensuite, il place l’hôte en mode maintenance.

Comportement de l’hôte en mode maintenance

Une fois que vous avez mis un hôte en mode maintenance, les actions suivantes sont affectées :

  • Aucune machine virtuelle ne peut être créée sur l’ordinateur hôte.
  • Les machines virtuelles ne peuvent pas être migrées vers l’hôte.
  • L’hôte est exclu des calculs d’évaluation de l’hôte effectués lors du placement de la machine virtuelle.
  • L’état de l’hôte n’est pas mis à jour.

Toutefois, vous pouvez effectuer les actions suivantes :

  • Supprimez l’hôte de VMM si vous vérifiez que l’hôte est disponible et que son agent est dans un état approprié.
  • Démarrez ou arrêtez des machines virtuelles sur l’hôte.
  • Modifiez les propriétés de l’hôte.
  • Migrez une machine virtuelle de l’hôte vers un autre hôte.

Exemples

Exemple 1 : Placer l’hôte spécifié en mode maintenance et enregistrer toutes les machines virtuelles en cours d’exécution

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Disable-SCVMHost -VMHost $VMHost

La première commande obtient l’objet hôte nommé VMHost01 et stocke l’objet dans la variable $VMHost.

La deuxième commande place toutes les machines virtuelles en cours d’exécution déployées sur l’hôte stockées dans $VMHost dans un état enregistré. Ensuite, il définit l’état de l’hôte sur « En mode maintenance ».

Exemple 2 : Utiliser la migration dynamique pour migrer toutes les machines virtuelles à haut niveau de disponibilité sur un nœud de cluster en mode maintenance

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> Disable-SCVMHost -VMHost $VMHost -MoveWithinCluster

La première commande obtient l’objet hôte nommé VMHost02 et stocke l’objet dans la variable $VMHost.

La deuxième commande utilise la migration dynamique pour migrer toutes les machines virtuelles hautement disponibles sur l’hôte stocké dans $VMHost vers un autre nœud du cluster. Il place d’autres machines virtuelles en cours d’exécution dans un état enregistré, puis définit la valeur de la propriété d’état hôte sur « En mode maintenance ».

Paramètres

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

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

-MoveWithinCluster

Indique que toutes les machines virtuelles actuellement déployées sur un hôte membre d’un cluster hôte seront migrées vers un autre hôte du même cluster hôte si cet hôte est placé en mode maintenance.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHost

Spécifie un objet ordinateur hôte d’ordinateur virtuel. VMM prend en charge les hôtes Hyper-V, les hôtes VMware ESX et les hôtes Citrix XenServer.

Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .

Type:Host
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Sorties

Host

Cette applet de commande retourne un objet Host .

Notes

  • Un hôte que vous placez en mode de maintenance temporaire est différent d’un hôte que vous désignez comme hôte de maintenance. Un hôte de maintenance est un hôte que vous dédiez pour les tâches de maintenance des machines virtuelles, par exemple :
  • Mise à jour corrective des machines virtuelles stockées et des modèles.
  • Création de machines virtuelles avec script intermédiaire avant de déplacer les machines virtuelles dans votre environnement de production.