Delen via

Grant-SCMACAddress

  • Referentie
Module:
VirtualMachineManager

Wijst het volgende beschikbare fysieke adres (MAC-adres) toe vanuit een MAC-adresgroep en wijst dit toe aan een virtuele netwerkadapter.

Syntaxis

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

Description

De Grant-SCMACAddress cmdlet wijst het volgende beschikbare fysieke adres toe, opgegeven als een Mac-adres (Media Access Control) uit een MAC-adresgroep en wijst deze toe aan een virtuele netwerkadapter. Als u een specifiek MAC-adres wilt toewijzen, gebruikt u de parameter MACAddress.

Voor informatie over het maken van MAC-adresgroepen, typt u: New-SCMACAddressPool -Detailed.

Voorbeelden

Voorbeeld 1: Een MAC-adres uit een MAC-adresgroep toewijzen en toewijzen aan een virtuele netwerkadapter

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 op host VMHost01 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht wordt het object van de virtuele netwerkadapter opgehaald voor de virtuele machine die is opgeslagen in $VM en wordt het object opgeslagen in de $VNIC variabele. In dit voorbeeld wordt ervan uitgegaan dat de virtuele machine slechts één virtuele netwerkadapter heeft.

Met de derde opdracht wordt het hostgroepobject opgehaald op het pad Alle hosts\HostGroup02\Production en wordt het object opgeslagen in de $HostGroup variabele.

De vierde opdracht haalt de MAC-adresgroep op die is gekoppeld aan de hostgroep die is opgeslagen in $HostGroup en de naam MAC-adresgroep 01.

Met de laatste opdracht wordt een MAC-adres toegewezen aan de virtuele netwerkadapter die is opgeslagen in $VNIC.

Voorbeeld 2: Een MAC-adres toewijzen vanuit een MAC-adresgroep en deze toewijzen aan een specifieke virtuele netwerkadapter

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM02 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht wordt het object van de virtuele netwerkadapter voor VM02 opgehaald met de site-id van 1 en wordt het object opgeslagen in de $VNIC variabele.

Met de derde opdracht wordt de MAC-adresgroep met de naam MAC-adresgroep 02 opgehaald en wordt het object opgeslagen in de variabele $MACAddressPool.

Met de laatste opdracht verleent u een MAC-adres van MAC-adresgroep 02 aan de virtuele netwerkadapter die is opgeslagen in $VNIC.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor het MAC-adres.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u een variabele op waarin de voortgang van de taak wordt bijgehouden en opgeslagen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MACAddress

Hiermee geeft u het MAC-adres of een set MAC-adressen op voor een fysieke of virtuele netwerkadapter op een computer.

  • Voorbeeldindeling voor één MAC-adres: -MACAddress "00-15-5D-B4-DC-00"
  • Voorbeeldindeling voor een set MAC-adressen: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MACAddressPool

Hiermee geeft u een MAC-adresgroep.

Type:MACAddressPool
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualNetworkAdapter

Hiermee geeft u een virtuele netwerkadapterobject voor een virtuele machine.

Het maximum aantal virtuele netwerkadapters varieert per type host. Als het hosttype Hyper-V is, is het maximum aantal virtuele netwerkadapters:

  • Maximaal vier geëmuleerde adapters per virtuele machine.
  • Maximaal acht synthetische adapters per virtuele machine. Een uitzondering is dat er geen stuurprogramma beschikbaar is voor een geëmuleerde netwerkadapter op een Windows Server 2003 x64-gast.

Als het hosttype VMware ESX is:

  • Maximaal vier geëmuleerde adapters per virtuele machine.

Als het hosttype Citrix XenServer is:

  • Maximaal zeven geëmuleerde adapters per virtuele machine.
Type:VirtualNetworkAdapter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject (Virtual Machine Manager) op.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

CloudPairing[]

Deze cmdlet retourneert een matrix van CloudPairing--objecten.

Notities

  • Hiervoor is een VMM MACAddressPool-object vereist, dat kan worden opgehaald met behulp van de cmdlet Get-SCMACAddressPool en een VMM virtual network adapter-object, dat kan worden opgehaald met behulp van de Get-SCVirtualNetworkAdapter cmdlet.