Grant-SCMACAddress
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 $VNICLa 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 $VNICLa 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 .