Add-SCVMHostNetworkAdapter
Agrega un adaptador de red físico en un host administrado por VMM a una red virtual.
Syntax
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 se puede conectar a varios adaptadores de red virtuales de las máquinas virtuales implementadas en dicho host.
VMM para System Center 2019 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: Agregar 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 $VMHostNetworkAdapter
El 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,1124
El 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 con 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 usa 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 22
El 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 tiene 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. Para realizar los pasos de este ejemplo en un host que sólo tenga un adaptador de red, instale antes 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 antes del comando final que incluye las mismas ejecuciones de identificador de grupo de trabajos.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualNetwork
Especifica un objeto de red virtual.
Type: | VirtualNetwork |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VLanID
Asigna un identificador numérico en el intervalo 1-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
Type: | UInt16 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | VlanMode |
Accepted values: | Access, Trunk, Invalid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VLanTrunkID
Asigna una lista de identificadores numéricos en el intervalo de 1 a 4094 a un adaptador de red físico de un host de Hyper-V.
Formato de ejemplo: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type: | UInt16[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | HostNetworkAdapter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Salidas
VMHostNetworkAdapter
Este cmdlet devuelve un objeto VMHostNetworkAdapter .