Get-SCVirtualNetworkAdapter
Obtient les 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.
Syntaxe
All
Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-All]
[-ParentTypeVMOrHost]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
HardwareProfile
Get-SCVirtualNetworkAdapter
-HardwareProfile <HardwareProfile>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
Get-SCVirtualNetworkAdapter
-VM <VM>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
Get-SCVirtualNetworkAdapter
-VMTemplate <Template>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VMHost
Get-SCVirtualNetworkAdapter
-VMHost <Host>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ID
Get-SCVirtualNetworkAdapter
[-ID] <Guid>
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
L’applet de commande Get-SCVirtualNetworkAdapter récupère un ou plusieurs objets de carte de réseau virtuel à 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 VMM (Virtual Machine Manager).
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 récupère 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 récupère 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 récupère 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 récupère tous les objets de profil matériel de la bibliothèque VMM, sélectionne l’objet de profil nommé NewHWProfile01, puis stocke l’objet dans la variable $HWProfile.
La deuxième commande récupère 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 récupère tous les objets subordonnés indépendamment de l’objet parent.
Par exemple, la commande Get-SCVirtualDiskDrive -All récupère tous les objets d’unité de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet modèle auquel chaque objet d’unité de disque virtuel est associé.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
All
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-HardwareProfile
Spécifie un objet de profil matériel.
Propriétés du paramètre
| Type: | HardwareProfile |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
HardwareProfile
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ID
Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ID
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom d’un objet réseau.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ID
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | UserRole |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ParentTypeVMOrHost
Indique que le type parent est une machine virtuelle ou un hôte.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
All
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-VM
Spécifie un objet de machine virtuelle.
Propriétés du paramètre
| Type: | VM |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
VM
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-VMHost
Spécifie un objet hôte de machine virtuelle. VMM prend en charge les hôtes Hyper-V, VMware ESX et Citrix XenServer.
Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .
Propriétés du paramètre
| Type: | Host |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
VMHost
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-VMMServer
Spécifie un objet serveur VMM.
Propriétés du paramètre
| Type: | ServerConnection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-VMTemplate
Spécifie un objet de modèle VMM utilisé pour créer des machines virtuelles.
Propriétés du paramètre
| Type: | Template |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Modèle |
Jeux de paramètres
Template
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
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 Get-SCVirtualMachine, Get-SCVMTemplate, ou Get-SCHardwareProfile applets de commande, respectivement.