Set-SCVirtualNetworkAdapter

Cambia las propiedades de un adaptador de red virtual asociado a una máquina virtual, una plantilla de máquina virtual o un perfil de hardware que se usa para crear máquinas virtuales en VMM.

Syntax

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   -SlotID <Int32>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   -JobGroup <Guid>
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   [-JobGroup <Guid>]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-IPv4Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv6Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv4AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-IPv6AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-VMMServer <ServerConnection>]
   [[-VirtualNetworkAdapter] <VirtualNetworkAdapter>]
   -VirtualNetwork <String>
   [-Checkpoint]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet Set-SCVirtualNetworkAdapter cambia una o varias propiedades de un adaptador de red virtual asociado a una máquina virtual, una plantilla de máquina virtual o un perfil de hardware que se usan para crear máquinas virtuales en un entorno de Virtual Machine Manager (VMM).

Las operaciones que puede realizar incluyen lo siguiente:

  • Conecte un adaptador de red virtual a una red virtual.

  • Desconecte un adaptador de red virtual de una red virtual.

  • Especifique una ubicación de red y una etiqueta de red en un adaptador de red virtual.

  • Especifique una dirección MAC en el adaptador de red virtual.

  • Habilite el uso de una red de área local virtual (VLAN) y especifique un identificador de VLAN (identificador numérico) para esa VLAN en el adaptador de red virtual.

Nota

  • Se incluye un nuevo parámetro [-PhysicalNetworkAdapterName] en VMM 2019 UR2 y versiones posteriores. Para obtener más información, vea Parámetros.
  • Los nuevos parámetros [-AllowedVLanList] y [-NativeVLanId] se incluyen en VMM 2019 UR3 y versiones posteriores. Para obtener más información, vea Parámetros.

Ejemplos

Ejemplo 1: Conexión de un adaptador de red virtual a una red virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VirtualNetwork "ExternalVirtualNetwork01"

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, selecciona el objeto de adaptador con la dirección física (MAC) de 00:16:D3:CC:00:1B y, a continuación, almacena el objeto en la variable $Adapter.

El último comando conecta el adaptador de red virtual almacenado en $Adapter a la red virtual denominada ExternalVirtualNetwork01 en el host que contiene VM01.

Ejemplo 2: Especificar una dirección MAC estática para un adaptador de red virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.ID -eq "5c0ee80a-731f-41c8-92f0-85a1619f9a1b" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -PhysicalAddressType "Static" -PhysicalAddress "00:16:D3:CC:00:1C"

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

El segundo comando obtiene todos los objetos del adaptador de red virtual en VM02, selecciona el adaptador de red virtual con el identificador especificado y, a continuación, almacena el objeto en la variable $Adapter. En este ejemplo se supone que este adaptador tiene actualmente una dirección MAC dinámica.

El último comando especifica que el adaptador de red virtual almacenado en $Adapter use la dirección MAC estática 00:16:D3:CC:00:1C.

Ejemplo 3: Especificar una dirección MAC estática y asignarla a un adaptador de red virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter (Get-VirtualNetworkAdapter -VM $VM | where { $_.ID -eq "95e9cfda-861c-44a3-b2ba-2f796dfe691c"}) -MACAddressType "Static" -MACAddress "00-00-00-00-00-00"

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

El segundo comando obtiene el objeto de adaptador de red virtual en VM03 por identificador, especifica que el adaptador usa un tipo de dirección MAC estático y le asigna una dirección MAC.

Ejemplo 4: Desconectar el adaptador de red virtual especificado de la red virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapters[1] -NoConnection

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

El segundo comando obtiene todos los objetos del adaptador de red virtual en VM04 y almacena los objetos del adaptador en $Adapters. En este ejemplo se supone que VM04 tiene al menos dos adaptadores de red virtual.

El último comando usa el parámetro NoConnection para desconectar el segundo adaptador de red virtual (Adaptadores[1]) de cualquier red virtual a la que esté conectado.

Ejemplo 5: Especificación de un grupo de puertos de VMware para una máquina virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapter = $VM.VirtualNetworkAdapters[0]
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VMwarePortGroup "VM Network"

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

El segundo comando almacena el primer adaptador de red virtual [0] en VM05 en la variable $Adapter.

El último comando establece el adaptador de red virtual para el adaptador almacenado en $Adapter a la red de máquina virtual, que es el nombre del grupo de puertos de VMware al que desea que este adaptador se conecte.

Parámetros

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:VirtualNetworkAdapterFlags
Accepted values:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowedVLanList

Especifica una lista de las LAN virtuales permitidas en un adaptador de red de máquina virtual.

Nota

Este parámetro es aplicable a VMM 2019 UR3 y versiones posteriores.

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

-Checkpoint

Indica que se usa el permiso Can Checkpoint.

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

-DevicePropertiesAdapterName

Especifica el nombre de un adaptador de red.

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

-DevicePropertiesAdapterNameMode

Especifica el modo de nombre del adaptador.

Type:DevicePropertiesAdapterNameMode
Accepted values:Disabled, VMNetwork, Custom
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableGuestIPNetworkVirtualizationUpdates

Indica si se habilitan las actualizaciones de virtualización de red IP por parte de un invitado.

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

-EnableMACAddressSpoofing

Habilita, cuando se establece en $True, suplantación de direcciones MAC.

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

-EnableVMNetworkOptimization

Habilita, cuando se establece en $True, optimización de red de máquina virtual.

Esta característica mejora el rendimiento de red de las máquinas virtuales con adaptadores de red que admiten la descarga de cola de máquinas virtuales (VMQ) o TCP Chimney. VMQ permite crear una cola de red única para cada adaptador de red virtual. La descarga de TCP Chimney permite descargar el procesamiento del tráfico de red desde la pila de red.

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

-IPv4Addresses

Especifica una lista de direcciones IPv4.

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv4Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressPools

Especifica una lista de grupos de direcciones IPv4.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv4AddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressType

Especifica un tipo de dirección IPv4. Los valores permitidos para este parámetro son los siguientes:

  • Dinámica
  • estática
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6Addresses

Especifica una lista de direcciones IPv6.

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv6Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPools

Especifica una lista de grupos de direcciones IPv6.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv6AddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressType

Especifica un tipo de dirección IPv6. Los valores permitidos para este parámetro son los siguientes:

  • Dinámica
  • estática
Type:EthernetAddressType
Accepted values:Dynamic, Static
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:True
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

-LogicalNetwork

Especifica una red lógica. Una red lógica es una agrupación con nombre de subredes IP y VLAN que se usan para organizar y simplificar las asignaciones de red.

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

-MACAddress

Especifica la dirección MAC, o un conjunto de direcciones MAC, para un adaptador de red físico o virtual en un equipo.

  • Formato de ejemplo para una sola dirección MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Formato de ejemplo para un conjunto de direcciones MAC: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Type:String
Aliases:EthernetAddress, PhysicalAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressType

Especifica el tipo de dirección MAC que se va a usar para un adaptador de red virtual. Los valores válidos son: Static, Dynamic.

Type:String
Aliases:EthernetAddressType, PhysicalAddressType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NativeVLanId

Especifica el identificador de LAN virtual nativo para un adaptador de red de máquina virtual.

Nota

Este parámetro es aplicable a VMM 2019 UR3 y versiones posteriores.

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

-NetworkLocation

Especifica la ubicación de red de un adaptador de red físico o de un adaptador de red virtual, o cambia la ubicación de red predeterminada de un adaptador de red físico de un host.

Formatos de ejemplo:

  • -NetworkLocation $NetLoc ($NetLoc puede contener Corp.Contoso.com)
  • -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkTag

Especifica una palabra o frase que se asocia a un adaptador de red virtual configurado para conectarse con una red interna o externa específica en el host.

El parámetro NetworkTag identifica todas las máquinas virtuales con la misma NetworkTag que los miembros de la misma red. VMM usa una neworkTag (si existe) cuando evalúa los hosts como posibles candidatos para implementar una máquina virtual. Si el host no incluye máquinas virtuales en la red con la misma networkTag que la máquina virtual que se va a colocar, el host recibe cero estrellas en el proceso de selección de ubicación.

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

-NoConnection

Desconecta un adaptador de red virtual de una red virtual.

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

-NoLogicalNetwork

Indica que no hay ninguna red lógica asociada a este adaptador de red virtual.

Type:SwitchParameter
Aliases:NoVMNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoPortClassification

Indica que no se proporciona una clasificación de puerto.

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

-OnBehalfOfUser

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

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

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

-PhysicalNetworkAdapterName

Especifica el nombre del adaptador de red físico.

Nota

Este parámetro es aplicable a VMM 2019 UR2 y versiones posteriores.

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

-PortACL

Especifica un objeto ACL de puerto.

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

-PortClassification

Especifica la clasificación de puerto del conmutador al que se conecta el adaptador de red virtual.

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

-PROTipID

Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (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

-RemovePortACL

Indica que esta operación quita la lista de control de acceso de puerto (ACL).

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

-RequiredBandwidth

Especifica el ancho de banda de red requerido por un adaptador de red.

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

-SlotID

Especifica un identificador numérico que se usa para identificar un dispositivo.

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

-VirtualNetwork

Especifica un objeto de red virtual.

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

-VirtualNetworkAdapter

Especifica un objeto de adaptador de red virtual para una máquina virtual.

Los tipos de hosts admiten el siguiente número de adaptadores de red virtual:

  • Hyper-V. Hasta cuatro adaptadores emulados por máquina virtual. No hay ningún controlador disponible para un adaptador de red emulado en un sistema operativo invitado windows Server 2003 x64.

  • Hyper-V. Hasta ocho adaptadores sintéticos por máquina virtual.

  • VMware ESX. Hasta cuatro adaptadores emulados por máquina virtual.

  • Citrix XenServer. Hasta siete adaptadores emulados por máquina virtual.

Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VLanEnabled

Indica si se va a habilitar una LAN virtual (VLAN) para que la usen las máquinas virtuales en un host de Hyper-V o Citrix XenServer.

  • Ejemplo: -VLANEnabled -VLANID 35
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 adaptador de red virtual de una máquina virtual enlazada a un adaptador de red físico en el host o enlazado a una red virtual interna en el host.

Formato de ejemplo: -VLanEnabled -VLANID 35

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

-VMMServer

Especifica un objeto de servidor VMM.

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

-VMNetwork

Especifica un objeto de red de máquina virtual.

Para obtener un objeto de red de máquina virtual, use el cmdlet Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Especifica una configuración de servicio de red de máquina virtual.

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

-VMSubnet

Especifica un objeto de subred de máquina virtual.

Para obtener un objeto VMSubnet , use el cmdlet Get-SCVMSubnet .

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

-VMwarePortGroup

Especifica el grupo de puertos de VMware.

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

Salidas

VirtualNetworkAdapter

Este cmdlet devuelve un objeto VirtualNetworkAdapter .

Notas

  • Requiere un objeto de adaptador de red virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVirtualNetworkAdapter .