Grant-SCMACAddress
Выделяет следующий доступный физический адрес (MAC-адрес) из пула MAC-адресов и назначает его виртуальному сетевому адаптеру.
Синтаксис
Grant-SCMACAddress
[-VMMServer <ServerConnection>]
[-MACAddress <String>]
-MACAddressPool <MACAddressPool>
-VirtualNetworkAdapter <VirtualNetworkAdapter>
[-Description <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Grant-SCMACAddress выделяет следующий доступный физический адрес, указанный как MAC-адрес из пула MAC-адресов и назначает его виртуальному сетевому адаптеру. Чтобы выделить определенный MAC-адрес, используйте параметр MACAddress.
Сведения о создании пулов MAC-адресов введите: New-SCMACAddressPool -Detailed
.
Примеры
Пример 1. Выделение MAC-адреса из пула MAC-адресов и назначение его виртуальному сетевому адаптеру
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
Первая команда получает объект виртуальной машины с именем VM01 на узле VMHost01 и сохраняет объект в переменной $VM.
Вторая команда получает объект адаптера виртуальной сети для виртуальной машины, хранящейся в $VM, и сохраняет объект в переменной $VNIC. В этом примере предполагается, что виртуальная машина имеет только один виртуальный сетевой адаптер.
Третья команда получает объект группы узлов по пути All Hosts\HostGroup02\Production и сохраняет объект в переменной $HostGroup.
Четвертая команда получает пул MAC-адресов, связанный с группой узлов, хранящейся в $HostGroup и именованном пуле MAC-адресов 01.
Последняя команда назначает MAC-адрес виртуальной сетевой адаптеру, хранящейся в $VNIC.
Пример 2. Выделение MAC-адреса из пула MAC-адресов и назначение его конкретному виртуальному сетевому адаптеру
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
Первая команда получает объект виртуальной машины с именем VM02 и сохраняет объект в переменной $VM.
Вторая команда получает объект виртуального сетевого адаптера для VM02 с идентификатором слота 1 и сохраняет объект в переменной $VNIC.
Третья команда получает пул MAC-адресов с именем MAC Address Pool 02 и сохраняет объект в переменной $MACAddressPool.
Последняя команда предоставляет MAC-адрес из пула MAC-адресов 02 адаптеру виртуальной сети, хранящейся в $VNIC.
Параметры
-Confirm
Запрашивает подтверждение перед запуском командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Description
Указывает описание MAC-адреса.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-JobVariable
Указывает переменную, в которой выполняется задание, отслеживается и сохраняется.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MACAddress
Указывает MAC-адрес или набор MAC-адресов для физического или виртуального сетевого адаптера на компьютере.
- Пример формата для одного MAC-адреса:
-MACAddress "00-15-5D-B4-DC-00"
- Пример формата для набора MAC-адресов:
-MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-MACAddressPool
Указывает пул MAC-адресов.
Тип: | MACAddressPool |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.
Тип: | Guid |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VirtualNetworkAdapter
Указывает объект виртуального сетевого адаптера для виртуальной машины.
Максимальное количество адаптеров виртуальной сети зависит от типа узла. Если тип узла — Hyper-V, максимальное число виртуальных сетевых адаптеров:
- До четырех эмулированных адаптеров на каждую виртуальную машину.
- До восьми синтетических адаптеров на каждую виртуальную машину. Исключением является то, что драйвер недоступен для эмулированного сетевого адаптера в гостевой системе Windows Server 2003 x64.
Если тип узла — VMware ESX:
- До четырех эмулированных адаптеров на каждую виртуальную машину.
Если тип узла — Citrix XenServer:
- До семи эмулированных адаптеров на каждую виртуальную машину.
Тип: | VirtualNetworkAdapter |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VMMServer
Указывает серверный объект VMM (Virtual Machine Manager).
Тип: | ServerConnection |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Выходные данные
CloudPairing[]
Этот командлет возвращает массив объектов CloudPairing.
Примечания
- Требуется объект MACAddressPool VMM, который можно получить с помощью командлета Get-SCMACAddressPool и объекта виртуального сетевого адаптера VMM, который можно получить
с помощью командлет а Get-SCVirtualNetworkAdapter .