Partager via

Get-SCVirtualNetwork

  • Référence
Module:
VirtualMachineManager

Obtient les objets de réseau virtuel configurés sur un hôte VMM.

Syntaxe

Get-SCVirtualNetwork
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHostCluster <HostCluster>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -ID <Guid>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCVirtualNetwork
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCVirtualNetwork obtient un ou plusieurs objets de réseau virtuel configurés sur un hôte géré par Virtual Machine Manager (VMM).

Pour plus d’informations sur les réseaux virtuels dans VMM, tapez Get-Help New-SCVirtualNetwork -Detailed.

Exemples

Exemple 1 : Obtenir tous les réseaux virtuels dans la base de données VMM

PS C:\> $VirtualNetworks = Get-SCVirtualNetwork 
PS C:\> $VirtualNetworks | Format-List Name,VMHost,VMHostNetworkadapters

La première commande obtient tous les objets de réseau virtuel sur tous les hôtes gérés par VMM et stocke les objets de réseau virtuel dans $VirtualNetworks.

La deuxième commande affiche un sous-ensemble d’informations sur chaque objet de réseau virtuel dans $VirtualNetworks : le nom de chaque réseau virtuel, l’hôte physique sur lequel chaque réseau virtuel est configuré et les cartes réseau physiques configurées sur l’hôte pour chaque réseau virtuel.

Exemple 2 : Obtenir tous les réseaux virtuels sur un hôte spécifique

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCVirtualNetwork -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 obtient tous les objets de réseau virtuel sur VMHost01 et affiche des informations sur chaque réseau virtuel.

Exemple 3 : Obtenir un réseau virtuel par nom à partir d’un hôte spécifique

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> $VN = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> $VN

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

La deuxième commande obtient l’objet de réseau virtuel nommé InternalVNet01 à partir de VMHost02 et stocke l’objet dans la variable $VN.

La dernière commande affiche des informations sur le réseau virtuel stocké dans $VN à l’utilisateur.

Paramètres

-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:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet VMM.

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

-VMHost

Spécifie un objet hôte de machine virtuelle. 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:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

-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

VirtualNetwork

Cette applet de commande retourne un objet VirtualNetwork.