Partager via

Grant-SCMACAddress

  • Référence
Module:
VirtualMachineManager

Alloue l’adresse physique disponible suivante à partir d’un pool d’adresses MAC et l’affecte à une carte réseau virtuelle.

Syntax

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

Description

L’applet de commande Grant-SCMACAddress alloue l’adresse physique disponible suivante, spécifiée en tant qu’adresse Media Access Control (MAC) à partir d’un pool d’adresses MAC et l’affecte à une carte réseau virtuelle. Pour allouer une adresse MAC spécifique, utilisez le paramètre MACAddress .

Pour plus d’informations sur la création de pools d’adresses MAC, tapez : New-SCMACAddressPool -Detailed.

Exemples

Exemple 1 : Allouer une adresse MAC à partir d’un pool d’adresses MAC et l’affecter à une carte réseau virtuelle

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

La première commande obtient l’objet de machine virtuelle nommé VM01 sur l’hôte VMHost01 et stocke l’objet dans la variable $VM.

La deuxième commande obtient l’objet de carte réseau virtuelle pour la machine virtuelle stockée dans $VM et stocke l’objet dans la variable $VNIC. Cet exemple suppose que la machine virtuelle n’a qu’une seule carte réseau virtuelle.

La troisième commande obtient l’objet de groupe hôte au chemin d’accès All Hosts\HostGroup02\Production et stocke l’objet dans la variable $HostGroup.

La quatrième commande obtient le pool d’adresses MAC associé au groupe hôte stocké dans $HostGroup et nommé pool d’adresses MAC 01.

La dernière commande affecte une adresse MAC à la carte réseau virtuelle stockée dans $VNIC.

Exemple 2 : Allouer une adresse MAC à partir d’un pool d’adresses MAC et l’affecter à une carte réseau virtuelle spécifique

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

La première commande obtient l’objet de machine virtuelle nommé VM02 et stocke l’objet dans la variable $VM.

La deuxième commande obtient l’objet de carte réseau virtuelle pour VM02 avec l’ID d’emplacement 1 et stocke l’objet dans la variable $VNIC.

La troisième commande obtient le pool d’adresses MAC nommé MAC Address Pool 02 et stocke l’objet dans la variable $MACAddressPool.

La dernière commande accorde une adresse MAC du pool d’adresses MAC 02 à la carte réseau virtuelle stockée dans $VNIC.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-Description

Spécifie une description de l’adresse MAC.

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

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

-MACAddress

Spécifie l’adresse MAC ou un ensemble d’adresses MAC pour une carte réseau physique ou virtuelle sur un ordinateur.

  • Exemple de format pour une seule adresse MAC : -MACAddress "00-15-5D-B4-DC-00"
  • Exemple de format pour un ensemble d’adresses 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

Spécifie un pool d’adresses MAC.

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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VirtualNetworkAdapter

Spécifie un objet carte réseau virtuelle pour un ordinateur virtuel.

Le nombre maximal de cartes réseau virtuelles varie selon le type d’hôte. Si le type d’hôte est Hyper-V, le nombre maximal de cartes réseau virtuelles est :

  • Jusqu’à quatre adaptateurs émulés par machine virtuelle.
  • Jusqu’à huit adaptateurs synthétiques par machine virtuelle. Une exception est qu’aucun pilote n’est disponible pour une carte réseau émulée sur un invité Windows Server 2003 x64.

Si le type d’hôte est VMware ESX :

  • Jusqu’à quatre adaptateurs émulés par machine virtuelle.

Si le type d’hôte est Citrix XenServer :

  • Jusqu’à sept adaptateurs émulés par machine virtuelle.
Type:VirtualNetworkAdapter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM (Virtual Machine Manager).

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Sorties

CloudPairing[]

Cette applet de commande retourne un tableau d’objets CloudPairing .

Notes

  • Nécessite un objet MACAddressPool VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCMACAddressPool et d’un objet de carte réseau virtuelle VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualNetworkAdapter .