New-SCVMHost
Создает узел VMM с физического компьютера с помощью свойств, определенных в профиле узла.
Синтаксис
New-SCVMHost
[-VMMServer <ServerConnection>]
[-Description <String>]
-ComputerName <String>
-VMHostProfile <PhysicalComputerProfile>
-SMBiosGuid <Guid>
[-VMHostGroup <HostGroup>]
[-IPAddress <String>]
[-LogicalNetwork <LogicalNetwork>]
[-Subnet <String>]
[-BypassADMachineAccountCheck]
[-ManagementAdapterMACAddress <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]New-SCVMHost
[-VMMServer <ServerConnection>]
-VMHostConfig <PhysicalComputerConfig>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]New-SCVMHost
[-VMMServer <ServerConnection>]
[-Description <String>]
-ComputerName <String>
-VMHostProfile <PhysicalComputerProfile>
-SMBiosGuid <Guid>
[-VMHostGroup <HostGroup>]
[-IPAddress <String>]
[-LogicalNetwork <LogicalNetwork>]
[-Subnet <String>]
[-BypassADMachineAccountCheck]
[-ManagementAdapterMACAddress <String>]
-BMCAddress <String>
-BMCRunAsAccount <RunAsAccount>
[-BMCPort <UInt32>]
-BMCProtocol <OutOfBandManagementType>
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]Описание
Командлет New-SCVMHost создает узел Virtual Machine Manager (VMM) с физического компьютера с помощью свойств, определенных в профиле узла. Физический компьютер должен иметь внеполосный контроллер.
Перед созданием узла убедитесь, что в VMM добавлен сервер PXE, создан профиль узла и все необходимые файлы драйверов добавлены в библиотеку. Примечание. Сервер PXE, добавляемый в VMM, должен находиться в той же подсети, что и физические компьютеры, которые требуется преобразовать в управляемые узлы Hyper-V.
Дополнительные сведения о типах узлов, поддерживаемых VMM, введите Get-Help Add-SCVMHost -Detailed.
Примеры
Пример 1. Создание узла с физического компьютера с помощью профиля узла на основе DHCP
PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -ComputerName "NewHost01" -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ManagementAdapterMACAddress "00-1D-D8-B7-1C-00" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.91"Первая команда получает объект учетной записи запуска от имени BMCRunAsAcct и сохраняет объект в переменной $BMCRAA.
Вторая команда обнаруживает физический компьютер с IP-адресом 10.10.0.1, используя учетную запись запуска от имени, указанную в $BMCRAA. Затем он сохраняет физический компьютер в переменной $NewPhysicalComputer.
Третья команда получает объект группы узлов с именем HostGroup01 и сохраняет объект в переменной $HostGroup.
Четвертая команда возвращает объект профиля узла с именем HostProfile01 и сохраняет объект в переменной $HostProfile. HostProfile01 настроен для получения IP-адреса через службу DHCP.
Последняя команда создает узел с физического компьютера, хранящегося в $NewPhysicalComputer с помощью профиля узла, хранящегося в $HostProfile, и присваивает ему имя NewHost01.
Пример 2. Создание узла с физического компьютера с помощью статического IP-профиля узла
PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ComputerName "NewHost02" -ManagementAdapterMACAddress "00-18-8B-0A-4D-76" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.1.1/24" -IPAddress "192.168.1.101"Первая команда получает объект учетной записи запуска от имени с именем BMCRunAsAccount и сохраняет объект в переменной $BMCRAA.
Вторая команда обнаруживает компьютер с адресом 10.10.0.1, используя учетную запись запуска от имени, хранящуюся в $BMCRAA, а затем сохраняет компьютер в переменной $NewPhysicalComputer.
Третья команда получает объект группы узлов с именем HostGroup01 и сохраняет объект в переменной $HostGroup.
Четвертая команда возвращает объект профиля узла с именем HostProfile02 и сохраняет объект в переменной $HostProfile. HostProfile02 настроен для выделения статического IP-адреса.
Последняя команда создает узел с физического компьютера, хранящегося в $NewPhysicalComputer с помощью профиля узла, хранящегося в $HostProfile, присваивает ему имя NewHost02 и настраивает MAC-адрес, IPAddress и подсеть.
Пример 3. Повторное развертывание существующего узла с новым профилем узла
PS C:\> $BMCRaa = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $OldHost = Get-SCVMHost "NewHost02"
PS C:\> $OldBMCIP = $OldHost.physicalmachine.BMCAddress
PS C:\> $OldBMCProtocol = $OldHost.physicalmachine.BMCType
PS C:\> $OldComputer = Find-SCComputer -BMCAddress $OldBMCIP -BMCRunAsAccount $BMCRAA -BMCProtocol $OldBMCProtocol
PS C:\> $OldGuid = $OldComputer.SMBIOSGUID
PS C:\> $OldAdapter = Get-SCVMHostNetworkAdapter -VMHost $OldHost
PS C:\> $OldMAC = $OldAdapter[0].macaddress
PS C:\> $OldRAA = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Remove-SCVMHost $OldHost -Credential $OldRAA
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $NewHostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $NewHostGroup -VMHostProfile $NewHostProfile -BMCAddress $OldBMCIP -BMCRunAsAccount $BMcRAA -BMCProtocol $OldBMCProtocol -SMBIOSGUID $OldGUID -ManagementAdapterMACAddress $OldMAC -ComputerName "Computer01" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.93"Первая команда возвращает объект учетной записи запуска от имени BMCRunAsAccount и сохраняет объект в переменной $BMCRaa.
Следующие восемь команд сохраняют свойства с узла, который вы собираетесь повторно развернуть.
Десятая команда удаляет старый узел из VMM.
Одиннадцатая команда возвращает объект группы узлов с именем New HostGroup01 и сохраняет объект в переменной $NewHostGroup.
Двенадцатая команда получает объект профиля узла с именем HostProfile02 и сохраняет объект в переменной $NewHostProfile.
Последняя команда повторно развертывает старый узел с помощью предыдущих параметров, определяющих узел, но для нового узла (хранящегося в $NewHostGroup) и обновленных параметров профиля (хранящихся в $NewHostProfile).
Параметры
-BMCAddress
Указывает или обновляет адрес контроллера управления базовой платой (BMC) для определенного физического компьютера. Это может быть IP-адрес, полное доменное имя (FQDN) или префикс DNS (обычно это имя совпадает с именем NetBIOS).
Как правило, адрес BMC и его подключение к сети отделены от IP-адреса, связанного со стандартным сетевым адаптером. Кроме того, некоторые компьютеры используют стандартный сетевой адаптер для предоставления единого адреса контроллера BMC и сетевого адаптера. Однако адрес BMC имеет уникальный порт и, таким образом, однозначно идентифицируется в сети.
- Пример формата IPv4:
-BMCAddress "10.0.0.21" - Пример формата Ipv6:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829" - Пример формата полного доменного имени:
-BMCAddress "Computer01.Contoso.com" - Пример формата NetBIOS:
-BMCAddress "Computer01"
Примечание. По умолчанию VMM использует IP-адрес или полное доменное имя для BMCAddress. Однако также можно создать модуль Windows PowerShell, который позволяет указать другие типы адресов в качестве адреса BMC.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
Указывает или обновляет объект поставщика конфигурации для контроллера управления базовой платой (BMC). Поставщик конфигурации — это подключаемый модуль к VMM, который преобразует команды PowerShell VMM в вызовы API, относящиеся к типу контроллера управления базовой платы. Этот параметр следует использовать с пользовательским BMCProtocol.
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCPort
Указывает или обновляет порт контроллера управления базовой платой (BMC) для определенного физического компьютера. Порт BMC также называется портом процессора службы. Примерами портов по умолчанию являются 623 для IPMI и 443 для SMASH через WS-Man.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCProtocol
Указывает или обновляет протокол, используемый VMM для взаимодействия с контроллером управления базовой платой (BMC). Допустимые значения: IPMI, SMASH, Custom.
BMC (также известный как процессор службы или контроллер управления) — это специализированный контроллер на материнской плате сервера, который действует в интерфейсе между аппаратным и системным программным обеспечением управления. Если системная плата физического компьютера включает BMC, то при подключении компьютера (включена ли она выключена или включена, а также установлена ли операционная система), сведения об оборудовании системы и состоянии работоспособности этого оборудования системы доступны.
Пример формата: -BMCProtocol "Custom"
Примечание. Для пользовательского протокола требуется использовать параметр BMCCustomConfigurationProvider .
| Type: | OutOfBandManagementType |
| Accepted values: | None, IPMI, SMASH, Custom |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCRunAsAccount
Указывает учетную запись запуска от имени, используемую с устройством контроллера управления базовой платой (BMC).
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassADMachineAccountCheck
Указывает, что этот командлет повторно использует учетную запись компьютера, которая уже существует в Active Directory. По умолчанию New-SCVMHost проверяет Active Directory для существующей учетной записи с указанным именем, чтобы предотвратить перезапись учетных записей компьютеров.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Указывает имя компьютера, который VMM может однозначно идентифицировать в сети. Допустимые значения для этого параметра:
- Полное доменное имя.
- IPv4 или IPv6-адрес
- NetBIOS-имя
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Задает описание узла VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Указывает IPv4 или IPv6-адрес.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной, имя которой указано в этом параметре.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalNetwork
Указывает логическую сеть. Логическая сеть — это именованной группирование IP-подсетей и виртуальных локальных сетей, которые используются для упорядочения и упрощения сетевых назначений.
| Type: | LogicalNetwork |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementAdapterMACAddress
Указывает MAC-адрес физического сетевого адаптера на компьютере, который будет использоваться сервером VMM для взаимодействия с этим узлом.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет выполнять аудит советов PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы элемент управления немедленно возвращал командную оболочку.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
Указывает глобальный уникальный идентификатор BIOS управления системой (GUID SMBIOS) для физического компьютера, связанного с записью для этого физического компьютера в VMM.
SMBIOS определяет структуры данных и методы доступа, позволяющие пользователю или приложению хранить и извлекать сведения об оборудовании на этом компьютере, например имя системы, производителя или версии BIOS системы. Windows получает данные SMBIOS при запуске системы и делает их доступными для программ.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Subnet
Указывает IP-подсеть (IPv4 или IPv6) в нотации Inter-Domain маршрутизации (CIDR).
- Пример формата для подсети IPv4:
192.168.0.1/24 - Пример формата для подсети IPv6:
FD4A:29CD:184F:3A2C::/64
Примечание. IP-подсеть не может перекрываться с любой другой подсетью в группе узлов или дочерних группах узлов.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostConfig
Указывает объект конфигурации физического компьютера.
| Type: | PhysicalComputerConfig |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Указывает объект группы узлов виртуальной машины.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostProfile
Указывает объект профиля узла виртуальной машины.
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Указывает объект сервера VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Выходные данные
Host
Этот командлет возвращает объект Host .
Примечания
- Требуется объект профиля узла, который можно получить с помощью командлета Get-SCVMHostProfile .