Get-SCVirtualNetworkAdapter

Référence

Module:: VirtualMachineManager

Obtient des objets de carte réseau virtuelle VMM à partir d’une machine virtuelle, d’un modèle de machine virtuelle ou d’un profil matériel.

Syntax

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-All]
   [-ParentTypeVMOrHost]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   -VMHost <Host>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [[-Name] <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCVirtualNetworkAdapter obtient un ou plusieurs objets de carte réseau virtuelle à partir d’un objet de machine virtuelle, d’un objet de modèle de machine virtuelle ou d’un objet de profil matériel dans un environnement Virtual Machine Manager (VMM).

Exemples

Exemple 1 : Obtenir des cartes réseau virtuelles à partir d’une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.

La deuxième commande obtient tous les objets de carte réseau virtuelle sur VM01 et affiche des informations sur les cartes à l’utilisateur.

Exemple 2 : Obtenir des cartes réseau virtuelles à partir d’un modèle de machine virtuelle

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate

La première commande obtient tous les objets de modèle de machine virtuelle de la bibliothèque VMM, sélectionne l’objet de modèle nommé VMTemplate01 et stocke l’objet dans la variable $VMTemplate.

La dernière commande obtient tous les objets de carte réseau virtuelle VMTemplate01 et affiche des informations sur ces cartes à l’utilisateur.

Exemple 3 : Obtenir des cartes réseau virtuelles à partir d’un profil matériel

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile

La première commande obtient tous les objets de profil matériel dans la bibliothèque VMM, sélectionne l’objet de profil nommé NewHWProfile01, puis stocke l’objet dans la variable $HWProfile.

La deuxième commande obtient tous les objets de carte réseau virtuelle NewHWProfile01 et affiche des informations sur ces cartes à l’utilisateur.

Paramètres

-All

Indique que cette applet de commande obtient tous les objets subordonnés indépendamment de l’objet parent.

Par exemple, la commande Get-SCVirtualDiskDrive -All obtient tous les objets de lecteur de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-HardwareProfile

Spécifie un objet profil matériel.

Type:	HardwareProfile
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Spécifie le nom d’un objet réseau.

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur spécifié par ce paramètre.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-ParentTypeVMOrHost

Indique que le type parent est une machine virtuelle ou un hôte.

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

-VM

Spécifie un objet ordinateur virtuel.

Type:	VM
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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:	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

-VMTemplate

Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.

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

Sorties

VirtualNetworkAdapter

Cette applet de commande retourne un objet VirtualNetworkAdapter .

Notes

Nécessite un objet de machine virtuelle VMM, un objet de modèle de machine virtuelle ou un objet de profil matériel, qui peut être récupéré à l’aide des applets de commande Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivement.