Grant-SCMACAddress
Aloca o próximo endereço físico disponível (endereço MAC) de um pool de endereços MAC e o atribui a um adaptador de rede virtual.
Sintaxe
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 aloca o próximo endereço físico disponível, especificado como um endereço MAC (Controle de Acesso à Mídia) de um pool de endereços MAC e o atribui a um adaptador de rede virtual. Para alocar um endereço MAC específico, use o parâmetro MACAddress.
Para obter informações sobre como criar pools de endereços MAC, digite: New-SCMACAddressPool -Detailed
.
Exemplos
Exemplo 1: Alocar um endereço MAC de um pool de endereços MAC e atribuí-lo 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 obtém o objeto de máquina virtual chamado VM01 no host VMHost01 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto do adaptador de rede virtual para a máquina virtual armazenado no $VM e armazena o objeto na variável $VNIC. Este exemplo pressupõe que a máquina virtual tenha apenas um adaptador de rede virtual.
O terceiro comando obtém o objeto do grupo de hosts no caminho All Hosts\HostGroup02\Production e armazena o objeto na variável $HostGroup.
O quarto comando obtém o pool de endereços MAC associado ao grupo de hosts armazenado no $HostGroup e chamado MAC Address Pool 01.
O último comando atribui um endereço MAC ao adaptador de rede virtual armazenado no $VNIC.
Exemplo 2: Alocar um endereço MAC de um pool de endereços MAC e atribuí-lo 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 de máquina virtual chamado VM02 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto do adaptador de rede virtual para VM02 com a ID do slot de 1 e armazena o objeto na variável $VNIC.
O terceiro comando obtém o pool de endereços MAC 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 para o adaptador de rede virtual armazenado no $VNIC.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Description
Especifica uma descrição para o endereço MAC.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-JobVariable
Especifica uma variável na qual o progresso do trabalho é controlado e armazenado.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MACAddress
Especifica o endereço MAC, ou um conjunto de endereços MAC, para um adaptador de rede físico ou virtual em um computador.
- Exemplo de formato para um único endereço MAC:
-MACAddress "00-15-5D-B4-DC-00"
- Exemplo de formato para um conjunto de endereços MAC:
-MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MACAddressPool
Especifica um pool de endereços MAC.
Tipo: | MACAddressPool |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
Tipo: | Guid |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-VirtualNetworkAdapter
Especifica um objeto de adaptador de rede virtual para uma máquina virtual.
O número máximo de adaptadores de rede virtual varia de acordo com o tipo de host. Se o tipo de host for Hyper-V, o número máximo de adaptadores de rede virtual é:
- Até quatro adaptadores emulados por máquina virtual.
- Até oito adaptadores sintéticos por máquina virtual. Uma exceção é que nenhum driver está disponível para um adaptador de rede emulado em um convidado do Windows Server 2003 x64.
Se o tipo de host for VMware ESX:
- Até quatro adaptadores emulados por máquina virtual.
Se o tipo de host for Citrix XenServer:
- Até sete adaptadores emulados por máquina virtual.
Tipo: | VirtualNetworkAdapter |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM (Virtual Machine Manager).
Tipo: | ServerConnection |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Saídas
CloudPairing[]
Este cmdlet retorna uma matriz de objetos CloudPairing.
Notas
- Requer um objeto MACAddressPool do VMM, que pode ser recuperado usando o cmdlet
Get-SCMACAddressPool , e um objeto de adaptador de rede virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVirtualNetworkAdapter.