Partager via

Get-SCVMHost

  • Référence
Module:
VirtualMachineManager

Récupère des objets de l’ordinateur hôte de l’ordinateur virtuel à partir de la base de données Virtual Machine Manager.

Syntax

Get-SCVMHost
   [-VMMServer <ServerConnection>]
   [[-ComputerName] <String>]
   [-ID <Guid>]
   [<CommonParameters>]
Get-SCVMHost
   -VMHostGroup <HostGroup>
   [[-ComputerName] <String>]
   [<CommonParameters>]
Get-SCVMHost
   -VMHostCluster <HostCluster>
   [[-ComputerName] <String>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCVMHost obtient un ou plusieurs objets hôtes de machine virtuelle à partir de la base de données Virtual Machine Manager (VMM). Les hôtes de machines virtuelles sont des ordinateurs physiques gérés par VMM sur lesquels vous pouvez déployer des machines virtuelles.

VMM prend en charge les types d'ordinateurs hôtes suivants :

  • Hôtes Hyper-V
  • Hôtes VMware ESX
  • Ordinateurs hôtes Citrix XenServer

Pour plus d’informations sur les hôtes de machine virtuelle dans Virtual Machine Manager, tapez Get-Help Add-VMHost -Detailed.

Exemples

Exemple 1 : Obtenir tous les hôtes gérés par le serveur VMM spécifié

PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com"

Cette commande obtient tous les objets hôtes pour tous gérés par VMMServer01 et affiche les propriétés de l’hôte à l’utilisateur.

Exemple 2 : Obtenir un hôte par nom

PS C:\> Get-SCVMHost -ComputerName "VMHost01.Contoso.com"

Cette commande obtient l’objet hôte nommé VMHost01 dans le domaine Contoso.com et affiche les propriétés de l’hôte à l’utilisateur.

Exemple 3 : Obtenir tous les hôtes d’un groupe hôte spécifique et afficher des informations à leur sujet à l’utilisateur

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01" -VMMServer "VMMServer01.Contoso.com"
PS C:\> $HostsInHG = Get-SCVMHost -VMHostGroup $HostGroup
PS C:\> $HostsInHG | Format-Table -Property Name, VMs

La première commande obtient l’objet de groupe hôte nommé HostGroup01 à partir de VMMServer01 et stocke l’objet dans la variable $HostGroup.

La deuxième commande obtient tous les objets hôtes du groupe hôte stockés dans $HostGroup et stocke les objets dans la variable $HostsInHG.

La dernière commande utilise l’opérateur de pipeline pour transmettre tous les objets hôtes stockés dans $HostsInHG à l’applet de commande Format-Table, qui affiche le nom de chaque hôte et les machines virtuelles déployées sur cet hôte dans une table.

Exemple 4 : Obtenir tous les hôtes d’un cluster hôte spécifique et afficher des informations à leur sujet à l’utilisateur

PS C:\> $Cluster = Get-SCVMHostCluster -Name "Cluster01.Contoso.com" -VMMServer "VMMServer01.Contoso.com"
PS C:\> $HostsInCluster = Get-SCVMHost -VMHostCluster $Cluster
PS C:\> $HostsInCluster | Format-Table -Property Name, VirtualizationPlatform

La première commande obtient l’objet de cluster hôte nommé Cluster01 à partir de VMMServer01 et stocke l’objet dans la variable $Cluster.

La deuxième commande obtient tous les objets hôtes dans Cluster01 et stocke les objets dans la variable $HostsInCluster.

La dernière commande transmet tous les objets hôtes stockés dans $HostsInCluster à l’applet de commande Format-Table, qui affiche le nom et la plateforme de virtualisation de chaque hôte dans Cluster01.

Exemple 5 : Obtenir un hôte spécifique situé sur un réseau de périmètre par son adresse IP

PS C:\> $VMHost = Get-VMHost -ComputerName 10.199.53.5 -VMMServer "VMMServer01.Contoso.com"
PS C:\> $VMHost | Select-Object -Property ComputerName, OperatingSystem

La première commande obtient l’objet hôte situé sur un réseau de périmètre dont l’adresse IP est 10.199.53.5 à partir de VMMServer01 et stocke l’objet dans la variable $VMHost.

La deuxième commande utilise l’opérateur de pipeline pour passer l’objet hôte dans $VMHost à l’applet de commande Select-Object , qui affiche le nom de l’ordinateur et le système d’exploitation de l’hôte.

Paramètres

-ComputerName

Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les formats valides sont les suivants :

  • FQDN
  • Adresse IPv4 ou IPv6
  • Nom NetBIOS

Remarque : Consultez les exemples d’une applet de commande spécifique pour déterminer comment cette applet de commande spécifie le nom de l’ordinateur.

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

-ID

Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.

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

-VMHostCluster

Spécifie un objet cluster hôte VMM.

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

-VMHostGroup

Spécifie un objet groupe hôte d'ordinateurs virtuels.

Type:HostGroup
Position:Named
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

Sorties

Host

Cette applet de commande retourne un objet Host .