Get-SCVirtualNetworkAdapter

  • Referencia
Módulo:
VirtualMachineManager

Obtiene objetos de adaptador de red virtual VMM de una máquina virtual, una plantilla de máquina virtual o un perfil de hardware.

Sintaxis

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

El cmdlet Get-SCVirtualNetworkAdapter obtiene uno o varios objetos de adaptador de red virtual de un objeto de máquina virtual, un objeto de plantilla de máquina virtual o un objeto de perfil de hardware en un entorno de Virtual Machine Manager (VMM).

Ejemplos

Ejemplo 1: Obtención de adaptadores de red virtual desde una máquina virtual

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

El primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.

El segundo comando obtiene todos los objetos del adaptador de red virtual en VM01 y muestra información sobre los adaptadores al usuario.

Ejemplo 2: Obtención de adaptadores de red virtual de una plantilla de máquina virtual

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

El primer comando obtiene todos los objetos de plantilla de máquina virtual de la biblioteca VMM, selecciona el objeto de plantilla denominado VMTemplate01 y almacena el objeto en la variable $VMTemplate.

El último comando obtiene todos los objetos de adaptador de red virtual VMTemplate01 y muestra información sobre estos adaptadores al usuario.

Ejemplo 3: Obtención de adaptadores de red virtual de un perfil de hardware

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

El primer comando obtiene todos los objetos de perfil de hardware de la biblioteca VMM, selecciona el objeto de perfil denominado NewHWProfile01 y, a continuación, almacena el objeto en la variable $HWProfile.

El segundo comando obtiene todos los objetos del adaptador de red virtual NewHWProfile01 y muestra información sobre estos adaptadores al usuario.

Parámetros

-All

Indica que este cmdlet obtiene todos los objetos subordinados independientemente del objeto primario.

Por ejemplo, el comando Get-SCVirtualDiskDrive -All obtiene todos los objetos de unidad de disco virtual independientemente del objeto de máquina virtual o del objeto de plantilla al que está asociado cada objeto de unidad de disco virtual.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-HardwareProfile

Especifica un objeto de perfil de hardware.

Tipo:HardwareProfile
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ID

Especifica el identificador numérico como identificador único global o GUID para un objeto específico.

Tipo:Guid
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto de red.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ParentTypeVMOrHost

Indica que el tipo primario es una máquina virtual o un host.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VM

Especifica un objeto de máquina virtual.

Tipo:VM
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMHost

Especifica un objeto host de máquina virtual. VMM admite hosts de Hyper-V, hosts de VMware ESX y hosts de Citrix XenServer.

Para obtener más información sobre cada tipo de host, consulte el cmdlet Add-SCVMHost.

Tipo:Host
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMTemplate

Especifica un objeto de plantilla VMM usado para crear máquinas virtuales.

Tipo:Template
Alias:Template
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

VirtualNetworkAdapter

Este cmdlet devuelve un objeto VirtualNetworkAdapter.

Notas

  • Requiere un objeto de máquina virtual VMM, un objeto de plantilla de máquina virtual o un objeto de perfil de hardware, que se puede recuperar mediante el uso de los cmdlets get-SCVirtualMachine, Get-SCVMTemplateo cmdlets Get-SCHardwareProfile, respectivamente.