Grant-SCMACAddress
Weist die nächste verfügbare physische Adresse (MAC-Adresse) aus einem MAC-Adresspool zu und weist es einem virtuellen Netzwerkadapter zu.
Syntax
Grant-SCMACAddress
[-VMMServer <ServerConnection>]
[-MACAddress <String>]
-MACAddressPool <MACAddressPool>
-VirtualNetworkAdapter <VirtualNetworkAdapter>
[-Description <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Grant-SCMACAddress weist die nächste verfügbare physische Adresse zu, die als Medien-Access Control (MAC)-Adresse aus einem MAC-Adresspool angegeben ist und ihm einen virtuellen Netzwerkadapter ordnet. Um eine bestimmte MAC-Adresse zuzuweisen, verwenden Sie den MACAddress-Parameter .
Informationen zum Erstellen von MAC-Adresspools geben Sie folgendes ein: New-SCMACAddressPool -Detailed
Beispiele
Beispiel 1: Zuweisen einer MAC-Adresse aus einem MAC-Adresspool und Zuweisen sie zu einem virtuellen Netzwerkadapter
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
Der erste Befehl ruft das virtuelle Computerobjekt namens VM01 auf host VMHost01 ab und speichert das Objekt in der $VM Variable.
Der zweite Befehl ruft das virtuelle Netzwerkadapterobjekt für den virtuellen Computer ab, der in $VM gespeichert ist, und speichert das Objekt in der $VNIC Variablen. In diesem Beispiel wird davon ausgegangen, dass der virtuelle Computer nur über einen virtuellen Netzwerkadapter verfügt.
Der dritte Befehl ruft das Hostgruppenobjekt im Pfad "All Hosts\HostGroup02\Production" ab und speichert das Objekt in der $HostGroup Variablen.
Der vierte Befehl ruft den MAC-Adresspool ab, der der Hostgruppe zugeordnet ist, die in $HostGroup gespeichert ist und den MAC-Adresspool 01 benannt hat.
Der letzte Befehl weist eine MAC-Adresse dem in $VNIC gespeicherten virtuellen Netzwerkadapter zu.
Beispiel 2: Zuweisen einer MAC-Adresse aus einem MAC-Adresspool und Zuweisen sie zu einem bestimmten virtuellen Netzwerkadapter
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
Der erste Befehl ruft das virtuelle Computerobjekt namens VM02 ab und speichert das Objekt in der $VM Variable.
Der zweite Befehl ruft das virtuelle Netzwerkadapterobjekt für VM02 mit der Steckplatz-ID von 1 ab und speichert das Objekt in der $VNIC Variablen.
Der dritte Befehl ruft den MAC-Adresspool namens MAC Address Pool 02 ab und speichert das Objekt in der $MACAddressPool Variablen.
Der letzte Befehl gewährt eine MAC-Adresse vom MAC-Adresspool 02 an den virtuellen Netzwerkadapter, der in $VNIC gespeichert ist.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für die MAC-Adresse an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MACAddress
Gibt die MAC-Adresse oder einen Satz von MAC-Adressen für einen physischen oder virtuellen Netzwerkadapter auf einem Computer an.
- Beispielformat für eine einzelne MAC-Adresse:
-MACAddress "00-15-5D-B4-DC-00"
- Beispielformat für eine Gruppe von MAC-Adressen:
-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
Gibt einen MAC-Adresspool an.
Type: | MACAddressPool |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualNetworkAdapter
Gibt ein virtuelles Netzwerkadapterobjekt für eine virtuelle Maschine an.
Die maximale Anzahl von virtuellen Netzwerkadaptern variiert je nach Hosttyp. Wenn der Hosttyp Hyper-V ist, lautet die maximale Anzahl von virtuellen Netzwerkadaptern:
- Bis zu vier emulierte Adapter pro virtuellen Computer.
- Bis zu acht synthetische Adapter pro virtuellen Computer. Eine Ausnahme besteht darin, dass kein Treiber für einen emulierten Netzwerkadapter auf einem Windows Server 2003 x64-Gast verfügbar ist.
Wenn der Hosttyp VMware ESX ist:
- Bis zu vier emulierte Adapter pro virtuellen Computer.
Wenn der Hosttyp Citrix XenServer ist:
- Bis zu sieben emulierte Adapter pro virtuellen Computer.
Type: | VirtualNetworkAdapter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt (Virtual Machine Manager) an.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Ausgaben
CloudPairing[]
Dieses Cmdlet gibt ein Array von CloudPairing-Objekten zurück.
Hinweise
- Erfordert ein VMM MACAddressPool-Objekt, das mithilfe des Cmdlets "Get-SCMACAddressPool " und einem virtuellen VMM-Netzwerkadapterobjekt abgerufen werden kann, das mithilfe des Cmdlets Get-SCVirtualNetworkAdapter abgerufen werden kann.