Compartir a través de

Grant-SCMACAddress

  • Referencia
Módulo:
VirtualMachineManager

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

Sintaxis

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 de Control de acceso multimedia (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: Asignar una dirección MAC desde un grupo de direcciones MAC y asignarla 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 pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

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

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

-JobVariable

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

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

-MACAddress

Especifica la dirección MAC, o un conjunto de direcciones MAC, para un adaptador de red física 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"
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MACAddressPool

Especifica un grupo de direcciones MAC.

Tipo:MACAddressPool
Posición:Named
Valor predeterminado:None
Requerido:True
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

-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

-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 no hay ningún controlador 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.
Tipo:VirtualNetworkAdapter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

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

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

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.