Compartir a través de

Grant-SCMACAddress

  • Referencia
Módulo:
VirtualMachineManager

Asigna la siguiente dirección física disponible (dirección MAC) desde un grupo de direcciones MAC y la asigna a un adaptador de red virtual.

Syntax

Grant-SCMACAddress
     [-VMMServer <ServerConnection>]
     [-MACAddress <String>]
     -MACAddressPool <MACAddressPool>
     -VirtualNetworkAdapter <VirtualNetworkAdapter>
     [-Description <String>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

El cmdlet Grant-SCMACAddress asigna la siguiente dirección física disponible, especificada como una dirección media Access Control (MAC) de un grupo de direcciones MAC y la asigna a un adaptador de red virtual. Para asignar una dirección MAC específica, use el parámetro MACAddress .

Para obtener información sobre cómo crear grupos de direcciones MAC, escriba: New-SCMACAddressPool -Detailed.

Ejemplos

Ejemplo 1: Asignación de una dirección MAC desde un grupo de direcciones MAC y asignación a un adaptador de red virtual

PS C:\> $VM = Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com" -Name "VM01"
PS C:\> $VNIC = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $MACAddressPool = Get-SCMACAddressPool -VMHostGroup $HostGroup -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACAddressPool -VirtualNetworkAdapter $VNIC

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

El segundo comando obtiene el objeto de adaptador de red virtual para la máquina virtual almacenada en $VM y almacena el objeto en la variable $VNIC. En este ejemplo se supone que la máquina virtual tiene solo un adaptador de red virtual.

El tercer comando obtiene el objeto de grupo host en la ruta de acceso All Hosts\HostGroup02\Production y almacena el objeto en la variable $HostGroup.

El cuarto comando obtiene el grupo de direcciones MAC asociado al grupo host almacenado en $HostGroup y denominado Grupo de direcciones MAC 01.

El último comando asigna una dirección MAC al adaptador de red virtual almacenado en $VNIC.

Ejemplo 2: Asignar una dirección MAC desde un grupo de direcciones MAC y asignarla a un adaptador de red virtual específico

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VNIC = Get-SCVirtualNetworkAdapter -VM $VM | where {$_.SlotId -eq 1}
PS C:\> $MACAddressPool = Get-SCMACAddressPool -Name "MAC Address Pool 02"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACAddressPool -VirtualNetworkAdapter $VNIC

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

El segundo comando obtiene el objeto de adaptador de red virtual para VM02 con el identificador de ranura 1 y almacena el objeto en la variable $VNIC.

El tercer comando obtiene el grupo de direcciones MAC denominado Grupo de direcciones MAC 02 y almacena el objeto en la variable $MACAddressPool.

El último comando concede una dirección MAC del grupo de direcciones MAC 02 al adaptador de red virtual almacenado en $VNIC.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Description

Especifica una descripción para la dirección MAC.

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

-JobVariable

Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.

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

-MACAddressPool

Especifica un grupo de direcciones MAC.

Type:MACAddressPool
Position:Named
Default value:None
Required:True
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

-VirtualNetworkAdapter

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

El número máximo de adaptadores de red virtual varía según el tipo de host. Si el tipo de host es Hyper-V, el número máximo de adaptadores de red virtual es:

  • Hasta cuatro adaptadores emulados por máquina virtual.
  • Hasta ocho adaptadores sintéticos por máquina virtual. Una excepción es que ningún controlador está disponible para un adaptador de red emulado en un invitado de Windows Server 2003 x64.

Si el tipo de host es VMware ESX:

  • Hasta cuatro adaptadores emulados por máquina virtual.

Si el tipo de host es Citrix XenServer:

  • Hasta siete adaptadores emulados por máquina virtual.
Type:VirtualNetworkAdapter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica un objeto de servidor VMM (Virtual Machine Manager).

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Salidas

CloudPairing[]

Este cmdlet devuelve una matriz de objetos CloudPairing .

Notas

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