Get-SCVirtualNetworkAdapter
Получает объекты виртуального сетевого адаптера VMM из виртуальной машины, шаблона виртуальной машины или профиля оборудования.
Синтаксис
All
Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-All]
[-ParentTypeVMOrHost]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
HardwareProfile
Get-SCVirtualNetworkAdapter
-HardwareProfile <HardwareProfile>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
Get-SCVirtualNetworkAdapter
-VM <VM>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
Get-SCVirtualNetworkAdapter
-VMTemplate <Template>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VMHost
Get-SCVirtualNetworkAdapter
-VMHost <Host>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ID
Get-SCVirtualNetworkAdapter
[-ID] <Guid>
[[-Name] <String>]
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Описание
Командлет Get-SCVirtualNetworkAdapter получает один или несколько объектов виртуального сетевого адаптера из объекта виртуальной машины, объекта шаблона виртуальной машины или объекта профиля оборудования в среде диспетчера виртуальных машин (VMM).
Примеры
Пример 1: получение виртуальных сетевых адаптеров от виртуальной машины
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM
Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.
Вторая команда получает все объекты виртуальных сетевых адаптеров на VM01 и отображает информацию об адаптерах пользователю.
Пример 2: получение виртуальных сетевых адаптеров из шаблона виртуальной машины
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate
Первая команда получает все объекты шаблона виртуальной машины из библиотеки VMM, выбирает объект шаблона с именем VMTemplate01 и сохраняет объект в переменной $VMTemplate.
Последняя команда получает все объекты виртуального сетевого адаптера VMTemplate01 и выводит информацию об этих адаптерах пользователю.
Пример 3: получение виртуальных сетевых адаптеров из профиля оборудования
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
Первая команда получает все объекты аппаратного профиля в библиотеке VMM, выбирает объект профиля с именем NewHWProfile01, а затем сохраняет объект в переменной $HWProfile.
Вторая команда получает все объекты виртуального сетевого адаптера NewHWProfile01 и выводит информацию об этих адаптерах пользователю.
Параметры
-All
Указывает, что этот командлет получает все подчиненные объекты независимо от родительского объекта.
Например, команда Get-SCVirtualDiskDrive -All получает все объекты виртуального диска независимо от объекта виртуальной машины или объекта шаблона, с которым связан каждый объект виртуального диска.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
All
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HardwareProfile
Указывает объект профиля оборудования.
Свойства параметра
| Тип: | HardwareProfile |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
HardwareProfile
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ID
Указывает числовой идентификатор в качестве глобального уникального идентификатора или GUID для конкретного объекта.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ID
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя сетевого объекта.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ID
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного в этом параметре.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.
Свойства параметра
| Тип: | UserRole |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ParentTypeVMOrHost
Указывает, что родительский тип является виртуальной машиной или узлом.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
All
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VM
Указывает объект виртуальной машины.
Свойства параметра
| Тип: | VM |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
VM
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMHost
Указывает объект узла виртуальной машины. VMM поддерживает узлы Hyper-V, VMware ESX и Citrix XenServer.
Дополнительные сведения о каждом типе узла см. в командлете Add-SCVMHost .
Свойства параметра
| Тип: | Host |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
VMHost
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMMServer
Указывает объект сервера VMM.
Свойства параметра
| Тип: | ServerConnection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMTemplate
Указывает объект шаблона VMM, используемый для создания виртуальных машин.
Свойства параметра
| Тип: | Template |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Шаблон |
Наборы параметров
Template
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Выходные данные
VirtualNetworkAdapter
Этот командлет возвращает объект VirtualNetworkAdapter .
Примечания
- Требуется объект виртуальной машины VMM, объект шаблона виртуальной машины или объект профиля оборудования, который можно получить с помощью командлетов Get-SCVirtualMachine, Get-SCVMTemplateили Get-SCHardwareProfile соответственно.