Partilhar via

Grant-SCMACAddress

  • Referência
Módulo:
VirtualMachineManager

Aloca o próximo endereço físico disponível (endereço MAC) a partir de um conjunto de endereços MAC e atribui-o a um adaptador de rede virtual.

Syntax

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

Description

O cmdlet Grant-SCMACAddress atribui o próximo endereço físico disponível, especificado como um endereço de Controlo de Acesso (MAC) de um conjunto de endereços MAC e atribui-o a um adaptador de rede virtual. Para alocar um endereço MAC específico, utilize o parâmetro MACAddress .

Para obter informações sobre a criação de piscinas de endereços MAC, escreva: New-SCMACAddressPool -Detailed.

Exemplos

Exemplo 1: Aloque um endereço MAC a partir de um conjunto de endereços MAC e atribua-o a um adaptador de rede 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

O primeiro comando recebe o objeto de máquina virtual chamado VM01 no anfitrião VMHost01 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto adaptador de rede virtual para a máquina virtual armazenado em $VM e armazena o objeto na variável $VNIC. Este exemplo pressupõe que a máquina virtual tem apenas um adaptador de rede virtual.

O terceiro comando obtém o objeto de grupo anfitrião no caminho All Hosts\HostGroup02\Produção e armazena o objeto na variável $HostGroup.

O quarto comando obtém o pool de endereços MAC associado ao grupo anfitrião armazenado em $HostGroup e nomeado MAC Address Pool 01.

O último comando atribui um endereço MAC ao adaptador de rede virtual armazenado em $VNIC.

Exemplo 2: Aloque um endereço MAC a partir de um conjunto de endereços MAC e atribua-o a um adaptador de rede 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

O primeiro comando obtém o objeto da máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O segundo comando obtém o objeto adaptador de rede virtual para VM02 com o ID de ranhura de 1 e armazena o objeto na variável $VNIC.

O terceiro comando obtém o endereço MAC Pool chamado MAC Address Pool 02 e armazena o objeto na variável $MACAddressPool.

O último comando concede um endereço MAC do MAC Address Pool 02 ao adaptador de rede virtual armazenado em $VNIC.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Description

Especifica uma descrição para o endereço MAC.

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

-JobVariable

Especifica uma variável em que o progresso do trabalho é rastreado e armazenado.

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

-MACAddress

Especifica o endereço MAC, ou um conjunto de endereços MAC, para um adaptador de rede físico ou virtual num computador.

  • Formato de exemplo para um único endereço MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Formato de exemplo para um conjunto de endereços 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 uma piscina de endereços MAC.

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

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-VirtualNetworkAdapter

Especifica um objeto adaptador de rede virtual para uma máquina virtual.

O número máximo de adaptadores de rede virtuais varia consoante o tipo de hospedeiro. Se o tipo de hospedeiro for Hyper-V, o número máximo de adaptadores de rede virtuais é:

  • Até quatro adaptadores emulados por máquina virtual.
  • Até oito adaptadores sintéticos por máquina virtual. Uma exceção é que nenhum controlador está disponível para um adaptador de rede emulsionado num hóspede do Windows Server 2003 x64.

Se o tipo de anfitrião for VMware ESX:

  • Até quatro adaptadores emulados por máquina virtual.

Se o tipo de hospedeiro for Citrix XenServer:

  • Até sete 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 um 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

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Saídas

CloudPairing[]

Este cmdlet devolve uma matriz de objetos CloudPairing .

Notas

  • Requer um objeto VMM MACAddressPool, que pode ser recuperado usando o cmdlet Get-SCMACAddressPool , e um objeto adaptador de rede virtual VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualNetworkAdapter .