Set-SCVMHostNetworkAdapter

Módulo:

VirtualMachineManager

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

Syntax

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 se pueden 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 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 las 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á.

Type:	LogicalNetwork
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableForPlacement

Indica si el proceso de selección de ubicación de VMM considera que este host o este volumen en un host son aptos como una posible ubicación en la que se van a 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 se usa este parámetro 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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Indica una descripción para el objeto especificado.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNetworkVirtualization

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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

-RemoveLogicalNetwork

Especifica una red lógica que se quitará.

Type:	LogicalNetwork
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUnassignedVLan

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

Type:	UInt16[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUplinkPortProfileSet

Quita el conjunto de perfiles de puerto de vínculo superior del adaptador de red host.

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

-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.

Type:	SubnetVLan[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	UplinkPortProfileSet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UsedForManagement

Indica si el objeto se usa para administrar hosts.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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:	Boolean
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 .

Vínculos relacionados

• Add-SCVMHostNetworkAdapter
• Get-SCVMHost
• Get-SCVMHostNetworkAdapter
• New-SCVirtualNetwork
• Remove-SCVMHostNetworkAdapter