Compartir a través de

Set-SCVMHostNetworkAdapter

  • Referencia
Módulo:
VirtualMachineManager

Cambia las propiedades relacionadas con la red de un adaptador de red físico en un host administrado por VMM.

Sintaxis

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanMode <VlanMode>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-AddOrSetLogicalNetwork <LogicalNetwork>]
   [-RemoveLogicalNetwork <LogicalNetwork>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanEnabled <Boolean>]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet set-SCVMHostNetworkAdapter cambia las propiedades relacionadas con la red para un adaptador de red físico en un host administrado por Virtual Machine Manager (VMM).

Entre las propiedades que puede cambiar con este cmdlet se incluyen:

  • Configuración de VLAN: puede usar los parámetros de VLAN para crear o modificar una sola VLAN o varias VLAN. Para obtener una ilustración de cómo especificar la configuración de VLAN, consulte los ejemplos.

Para obtener más información sobre las VLAN y ejemplos adicionales que ilustran la configuración de VLAN, escriba Get-Help Add-SCVMHostNetworkAdapter -Detailed.

Ejemplos

Ejemplo 1: Creación de una nueva red virtual en un adaptador de red host y especificación de un identificador de VLAN para la red virtual

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

El primer comando obtiene el objeto host denominado VMHost02 y almacena el objeto en la variable $VMHost.

El segundo comando obtiene el objeto de adaptador de red host con un nombre que comienza por "Intel(R) PRO/1000 en VMHost02 y almacena el objeto en la variable $HostAdapter.

El tercer comando crea una red virtual denominada VirtualNetwork01 en VMHost02 que está enlazada al adaptador de host almacenado en $HostAdapter.

El último comando habilita una VLAN, establece el modo en Access (que enruta el tráfico internamente dentro de una sola VLAN) y asigna al adaptador de red un VLANID de 35.

Nota: En este ejemplo se supone que el host ya está conectado a una VLAN o, si no es así, 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.

Ejemplo 2: Agregar etiquetas VLan a un adaptador de red host configurado en modo tronco

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

El primer comando obtiene el objeto host denominado VMHost03 y almacena el objeto en la variable $VMHost.

El segundo comando obtiene el objeto de adaptador de red host especificando el nombre del adaptador y almacena el objeto en la variable $VMHostNIC.

El tercer comando usa la propiedad VlanTags del objeto de adaptador de red host ($VMHostNIC.VlanTags) y concatena una nueva matriz de etiquetas. La matriz actualizada conserva los VlanTag exisiting y agrega las etiquetas enumeradas a la matriz. El resultado de la concatenación se almacena en $NewVlanTags.

El último comando pasa la nueva lista de etiquetas VLAN al parámetro VLANTrunkID de Set-VMHostNetworkAdapter. El parámetro VLANMode debe especificar el valor "Trunk" siempre que se use el parámetro VLANTrunkID para modificar la lista de identificadores numéricos del tronco VLAN.

Parámetros

-AddOrSetLogicalNetwork

Especifica una red lógica que se agregará o actualizará.

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

-AvailableForPlacement

Indica si el proceso de selección de ubicación de VMM considera que este host o este volumen de un host son aptos como una posible ubicación en la que implementar máquinas virtuales. Si este parámetro se establece en $False, puede optar por implementar máquinas virtuales en este host o volumen de todos modos. El valor predeterminado es $True. Este parámetro no se aplica a los hosts de VMware ESX.

Cuando este parámetro se usa con adaptadores de red, si se establece en $False, la selección de ubicación no tendrá en cuenta las redes lógicas configuradas en este adaptador de red para determinar si el host es adecuado para conectar una máquina virtual.

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

-Description

Indica una descripción para el objeto especificado.

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

-EnableNetworkVirtualization

Especifica si la virtualización de red está habilitada. El valor predeterminado es $False.

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

-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

-RemoveLogicalNetwork

Especifica una red lógica que se quitará.

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

-RemoveUnassignedVLan

Especifica que las VLAN especificadas se quitarán del tronco VLAN del adaptador si no están asociados a una red lógica.

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

-RemoveUplinkPortProfileSet

Quita el perfil de puerto de vínculo superior establecido del adaptador de red host.

Tipo:SwitchParameter
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

-SubnetVLan

Especifica una o varias subredes IP y conjuntos de VLAN.

Para obtener información sobre cómo crear una subnetVLan, escriba Get-Help New-SCSubNetVLan.

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

-UplinkPortProfileSet

Especifica un objeto de conjunto de perfiles de puerto de vínculo superior.

Para obtener un objeto de conjunto de perfiles de puerto de vínculo superior, use el cmdlet get-SCUplinkPortProfileSet .

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

-UsedForManagement

Indica si el objeto se usa para administrar hosts.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
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:Boolean
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.