Grant-SCMACAddress

Выделяет следующий доступный физический адрес (MAC-адрес) из пула MAC-адресов и назначает его виртуальному сетевому адаптеру.

Синтаксис

Default (по умолчанию)

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-адресов и назначает его виртуальному сетевому адаптеру. Чтобы назначить определенный 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

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

Указывает описание для MAC-адреса.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

Указывает переменную, в которой отслеживается и сохраняется ход выполнения задания.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-MACAddressPool

Указывает пул MAC-адресов.

Свойства параметра

Тип:MACAddressPool
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VirtualNetworkAdapter

Указывает объект виртуального сетевого адаптера для виртуальной машины.

Максимальное количество виртуальных сетевых адаптеров зависит от типа узла. Если тип узла — Hyper-V, максимальное количество виртуальных сетевых адаптеров составляет:

  • До четырех эмулируемых адаптеров на одну виртуальную машину.
  • До восьми синтетических адаптеров на виртуальную машину. Исключением является отсутствие драйвера для эмулированного сетевого адаптера в гостевой системе Windows Server 2003 x64.

Если тип хоста — VMware ESX:

  • До четырех эмулируемых адаптеров на одну виртуальную машину.

Если тип хоста — Citrix XenServer:

  • До семи эмулируемых адаптеров на одну виртуальную машину.

Свойства параметра

Тип:VirtualNetworkAdapter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

Указывает объект сервера VMM (Virtual Machine Manager).

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

CloudPairing

Этот командлет возвращает массив объектов CloudPairing .

Примечания

  • Требуется объект VMM MACAddressPool, который можно получить с помощью командлета Get-SCMACAddressPool , и объект виртуального сетевого адаптера VMM, который можно получить с помощью командлета Get-SCVirtualNetworkAdapter .