Add-SCVMHostNetworkAdapter
Agrega un adaptador de red físico en un host administrado por VMM a una red virtual.
Sintaxis
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
El cmdlet Add-SCVMHostNetworkAdapter agrega un adaptador de red físico (también denominado tarjeta de interfaz de red o NIC) en un host administrado por Virtual Machine Manager (VMM) a una red virtual. Cada máquina virtual de ese host también puede conectarse a través de un adaptador de red virtual a esa red virtual.
Una red virtual configurada en un host puede conectarse a varios adaptadores de red virtual en máquinas virtuales implementadas en ese host.
VMM para System Center 2019 y versiones posteriores incluye compatibilidad con redes virtuales para configurar una o varias redes de área local virtual (VLAN) en un host. Puede usar el cmdlet Add-SCVMHostNetworkAdapter o el cmdlet Set-SCVMHostNetworkAdapter para configurar una sola VLAN o varias VLAN en un host. Para configurar las opciones de VLAN correspondientes en una máquina virtual, use el cmdlet New-SCVirtualNetworkAdapter o el cmdlet Set-SCVirtualNetworkAdapter.
Para obtener una ilustración de cada tipo de VLAN, consulte los ejemplos de este cmdlet.
Ejemplos
Ejemplo 1: Adición de un adaptador de red de host físico a una red virtual
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapterEl primer comando obtiene el objeto host denominado VMHost01 y almacena el objeto en la variable $VMHost.
El segundo comando obtiene el objeto de red virtual denominado ExternalVirtualNetwork01 en VMHost01 y almacena el objeto en la variable $VirtualNetwork.
El tercer comando obtiene el objeto de adaptador de red físico denominado HostAdapter01 en VMHost01 y almacena el objeto en la variable $VMHostNetworkAdapter.
El último comando agrega HostAdapter01 a ExternalVirtualNetwork01.
Nota: Solo puede agregar un adaptador de host físico por red virtual. Por lo tanto, se producirá un error en el último comando si un adaptador ya está asociado a la red virtual especificada. Para agregar un nuevo adaptador a la red virtual, primero debe quitar el adaptador de host existente.
Ejemplo 2: Adición de un adaptador de red de host físico a una VLAN que usa el modo "Tronco"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124El primer comando obtiene el objeto host denominado VMHost02 y almacena el objeto en la variable $VMHost.
El segundo comando obtiene el objeto de red virtual denominado ExternalNetwork02 en VMHost02 y almacena el objeto en la variable $VirtualNetwork.
El tercer comando obtiene el objeto de adaptador de red denominado HostAdapter02 en VMHost02 y almacena el objeto de adaptador en la variable $VMHostNetworkAdapter.
El último comando agrega HostAdapter02 a la red virtual ExternalNetwork02 y habilita el acceso desde ExternalNetwork02 a un dispositivo de red externo mediante 802.1Q etiquetado VLAN 1, 2, 100, 200, 200 y 1124.
Nota: Solo puede agregar un adaptador de host por red virtual, por lo que se producirá un error en el último comando si un adaptador ya está asociado a la red virtual especificada.
Ejemplo 3: Agregar un adaptador de red de host físico a una VLAN que use el modo "Access"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22El primer comando obtiene el objeto host denominado VMHost03 y almacena el objeto en la variable $VMHost.
El segundo comando obtiene el objeto de red virtual denominado ExternalNetwork03 en VMHost03 y almacena el objeto en la variable $VirtualNetwork.
El tercer comando obtiene el objeto de adaptador de red denominado HostAdapter03 en VMHost03 y almacena el objeto de adaptador en la variable$VMHostNetworkAdapter.
El último comando agrega HostAdapter03 a la red virtual ExternalNetwork03 y restringe el acceso a ExternalNetwork03 a VLANID 22.
Nota: Solo puede agregar un adaptador de host por red virtual, por lo que se producirá un error en el último comando si un adaptador ya está asociado a la red virtual especificada.
Precaución: En este ejemplo se supone que el host ya está conectado a una VLAN o, si no es así, asegúrese de que el host tenga dos adaptadores de red. Si el host tiene un único adaptador de red, asignar el adaptador a una VLAN que no está disponible para el servidor VMM impedirá que VMM administre el host. Puede realizar los pasos descritos en este ejemplo en un host que tenga solo un adaptador de red si instala por primera vez el adaptador de bucle invertido de Microsoft en el servidor.
Parámetros
-JobGroup
Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PROTipID
Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.
| Tipo: | Guid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VirtualNetwork
Especifica un objeto de red virtual.
| Tipo: | VirtualNetwork |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-VLanEnabled
Habilita una LAN virtual (VLAN) para que la usen las máquinas virtuales en un host de Hyper-V o Citrix XenServer.
Formato de ejemplo para una sola VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35 formato de ejemplo para varias VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VLanID
Asigna un identificador numérico en el intervalo de 1 a 4094 a un adaptador de red virtual en una máquina virtual o a un adaptador de red físico en un host de máquina virtual.
Configure un VLanID en un host de Hyper-V, VMware ESX o Citrix XenServer:
-- En un adaptador de red físico enlazado externamente cuando el modo VLan es Access.
Configure un VLanID en un adaptador de red virtual de una máquina virtual:
- Enlazado a un adaptador de red físico en el host o
- Enlazado a una red virtual interna en el host.
Formato de ejemplo: -VLanEnabled``-VLanMode "Access" -VLANID 35
| Tipo: | UInt16 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VLanMode
Especifica si una LAN virtual (VLAN) en un host de máquina virtual admite el tráfico entre una sola VLAN (modo de acceso) o entre varias VLAN (modo de tronco). Los valores válidos son: Access, Trunk.
| Tipo: | VlanMode |
| Valores aceptados: | Access, Trunk, Invalid |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VLanTrunkID
Asigna una lista de identificadores numéricos en el intervalo de 1 a 4094 a un adaptador de red físico en un host de Hyper-V.
Formato de ejemplo: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| Tipo: | UInt16[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VMHostNetworkAdapter
Especifica un objeto de adaptador de red físico en un host al que se pueden conectar las máquinas virtuales implementadas en ese host.
Formato de ejemplo: -VMHostNetworkAdapter $VMHostNIC
| Tipo: | HostNetworkAdapter |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
Salidas
VMHostNetworkAdapter
Este cmdlet devuelve un objeto VMHostNetworkAdapter.