Partager via

Get-SCVMHost

  • Référence
Module:
VirtualMachineManager

Obtient des objets hôtes de machine virtuelle à partir de la base de données Virtual Machine Manager.

Syntaxe

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’hôtes suivants :

  • hôtes Hyper-V
  • Hôtes VMware ESX
  • 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 sur celles-ci à 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 sur celles-ci à 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMHostCluster

Spécifie un objet de cluster hôte VMM.

Type:HostCluster
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMHostGroup

Spécifie un objet de groupe hôte de machine virtuelle.

Type:HostGroup
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

Host

Cette applet de commande retourne un objet Host.