Partager via

Remove-SCVMHost

  • Référence
Module:
VirtualMachineManager

Supprime un hôte de machine virtuelle de VMM.

Syntax

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Credential <VMMCredential>]
      [-RemoveHostWithVMs]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-SCVMHost supprime un ou plusieurs hôtes de machine virtuelle de Virtual Machine Manager (VMM). L’applet de commande Remove-SCVMHost fonctionne comme suit :

  • Serveur hôte uniquement. Si cet ordinateur est un hôte Hyper-V, mais n’est pas également un serveur de bibliothèque, l’objet hôte est supprimé de la base de données VMM et le logiciel de l’agent VMM est désinstallé du serveur hôte physique.

Si l’hôte est un hôte VMware ESX ou un hôte Citrix XenServer, l’objet hôte est supprimé de la base de données VMM. VMM n’installe pas d’agent sur des hôtes ESX ou des hôtes XenServer.

  • Hôte et serveur de bibliothèque. Si cet ordinateur est un hôte Hyper-V et est également un serveur de bibliothèque, cette commande supprime uniquement la fonctionnalité hôte, mais laisse la fonctionnalité de serveur de bibliothèque en place. Autrement dit, l’objet hôte est supprimé de la base de données VMM, mais le logiciel de l’agent VMM n’est pas désinstallé du serveur physique. L’objet serveur de bibliothèque demeure dans la base de données.

Si l’hôte est un hôte ESX, il peut fonctionner uniquement en tant qu’hôte de machine virtuelle dans VMM. Il ne peut pas faire à la fois office d’ordinateur hôte et de serveur de bibliothèque.

  • Informations d'identification. Si un hôte Hyper-V est joint à un domaine Active Directory, vous devez fournir des informations d’identification pour un compte disposant des autorisations appropriées pour supprimer cet ordinateur hôte de VMM.

Vous n’avez pas besoin de fournir des informations d’identification Active Directory pour supprimer un hôte réseau de périmètre, un hôte ESX ou un hôte XenServer de VMM.

  • Machines virtuelles. Lorsque vous supprimez un hôte, l’hôte n’est plus géré par VMM. Toutefois, toutes les machines virtuelles sur le serveur hôte ne seront pas supprimées ou dissociées du serveur. Tous les ordinateurs virtuels en cours de fonctionnement ne sont pas arrêtés. Bien que les machines virtuelles ne soient plus gérées par VMM, elles ne sont pas affectées d’une autre façon.
  • Suppression forcée. Vous pouvez utiliser le paramètre Force avec l’applet de commande Remove-SCVMHost pour supprimer un hôte de machine virtuelle de VMM lorsque vous n’avez pas d’informations d’identification appropriées pour gérer cet hôte ou lorsque le serveur VMM ne peut plus communiquer avec cet hôte.

Lorsque vous spécifiez le paramètre Force , VMM ne demande pas ou ne vérifie pas les informations d’identification, ni VMM tente de se connecter à l’hôte et de désinstaller l’agent VMM. Par conséquent, l’utilisation du paramètre Force est recommandée uniquement lors de la suppression d’enregistrements hôtes obsolètes de la base de données VMM.

Cette applet de commande retourne l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur $True) ou retourne un message d’erreur en cas d’échec.

Exemples

Exemple 1 : Supprimer un hôte joint à un domaine spécifique de VMM

PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm

La première commande utilise l’applet de commande Get-Credential pour vous inviter à fournir un nom d’utilisateur et un mot de passe et stocke les informations d’identification fournies dans la variable $Credential. Les informations d’identification requises pour cette opération sont un compte de domaine disposant de droits d’administrateur pour supprimer un serveur hôte Windows joint à un domaine Active Directory de VMM.

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

La troisième commande supprime l’objet hôte stocké dans $VMHost. À mesure que cette commande est traitée, $Credential fournit des informations d’identification à Remove-VMHost et le paramètre Confirm vous invite à confirmer que vous souhaitez supprimer cet hôte de VMM.

Exemple 2 : Supprimer tous les hôtes qui ne sont pas des nœuds dans un cluster hôte de VMM

PS C:\> Get-SCVMHost | where {$_.HostCluster -eq $NULL} | where {$_.VirtualizationPlatform -eq "VMwareESX" -or $_.PerimeterNetworkHost -eq 1 -or $_.NonTrustedDomainHost -eq 1} | Remove-SCVMHost -Confirm
PS C:\> $Credential = Get-Credential
PS C:\> Get-VMHost | where {$_.HostCluster -eq $NULL -and $_.VirtualizationPlatform -ne "VMwareESX" -and $_.PerimeterNetworkHost -eq 0 -and $_.NonTrustedDomainHost -eq 0} | Remove-VMHost -Credential $Credential -Confirm

La première commande obtient tous les objets hôtes, exclut tous les hôtes qui sont des nœuds dans un cluster hôte, sélectionne uniquement ces objets qui représentent les hôtes VMware ESX, les hôtes de réseau de périmètre ou les hôtes de domaine non approuvés, puis supprime ces objets de VMM si vous confirmez que vous souhaitez les supprimer. Les informations d’identification ne sont pas requises pour la suppression de ces ordinateurs hôtes.

La deuxième commande vous invite à fournir un nom d’utilisateur et un mot de passe pour un compte disposant d’autorisations pour supprimer les hôtes Windows joints à un domaine de VMM et stocker vos informations d’identification dans $Credential.

La dernière commande obtient tous les objets hôtes windows joints au domaine qui ne font pas partie d’un cluster hôte et transmet les objets à l’applet de commande Remove-VMHost . Comme cette commande est traitée, $Credential fournit vos informations d’identification à Remove-VMHost et le paramètre Confirm vous invite à confirmer que vous souhaitez supprimer ces hôtes de VMM.

Exemple 3 : Supprimer un hôte spécifique que vous ne pouvez plus accéder à partir de VMM

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm

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

La deuxième commande bascule sur le paramètre Force pour vous assurer que VMHost03 est supprimé de la base de données VMM. Les informations d’identification ne sont pas requises pour effectuer cette opération. Le paramètre Confirm vous invite à confirmer que vous souhaitez supprimer cet hôte.

Remarque : Vous pouvez utiliser le paramètre Force pour supprimer un hôte de VMM lorsque vous n’avez pas les informations d’identification de cet hôte ou lorsque le serveur VMM ne peut plus communiquer avec cet hôte.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un objet d’informations d’identification ou, pour certaines applets de commande, un objet de compte d’identification qui contient le nom d’utilisateur et le mot de passe d’un compte disposant de l’autorisation d’effectuer cette action. Ou, dans le cas de Restart-SCJob, dispose de l’autorisation d’effectuer une tâche redémarrée.

Pour plus d’informations sur l’objet PSCredential , tapez Get-Help Get-Credential.

Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources 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

-RemoveHostWithVMs

Pour plus d’informations sur l’objet PSCredential , tapez Get-Help Get-Credential.

Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.

Type:SwitchParameter
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

-VMMServer

Spécifie un objet serveur VMM.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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