Register-SCVirtualMachine
Регистрирует в VMM существующую виртуальную машину, которая в настоящее время не зарегистрирована на платформе виртуализации какого-либо узла, управляемого VMM, и не хранится в библиотеке VMM.
Синтаксис
Default (по умолчанию)
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Описание
Командлет Register-SCVirtualMachine регистрирует существующую виртуальную машину с помощью диспетчера виртуальных машин (VMM). Зарегистрируйте узел, который в данный момент не зарегистрирован на платформе виртуализации какого-либо узла, управляемого VMM, и не хранится в библиотеке VMM. Платформами виртуализации являются Hyper-V, VMware и XenServer. Если файлы виртуальной машины хранятся в библиотеке VMM, вам не нужно регистрировать виртуальную машину перед ее развертыванием на узле.
Файлы конфигурации для регистрации виртуальной машины должны храниться либо в файловой системе на узле, на котором должна быть развернута виртуальная машина, либо в общем хранилище, доступном для этого узла.
Чтобы зарегистрировать виртуальную машину для Hyper-V узла, файлы конфигурации для этой виртуальной машины должны быть сохранены в папке в файловой системе узла или в общем хранилище. Кроме того, необходимо создать экспорт виртуальной машины с помощью команды Экспорт в консоли Hyper-V Manager. В пути должна быть указана папка.
Чтобы зарегистрировать виртуальную машину для узла VMware ESX, конфигурация VMware .vmx должна храниться в файловой системе узла или в общем хранилище. Отдельного шага экспорта нет. В пути необходимо указать папку и файл конфигурации.
Не используйте этот командлет для регистрации виртуальных машин на узле XenServer.
Примеры
Пример 1: Регистрация существующей виртуальной машины на Hyper-V узле
PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"
Первая команда получает объект Hyper-V хоста с именем HyperVHost01, а затем сохраняет этот объект в переменной $VMHost.
Вторая команда добавляет существующую виртуальную машину на HVHost02 в VMM, указывая путь к папке, содержащей файл конфигурации виртуальной машины.
Пример 2: Регистрация существующей виртуальной машины на узле VMware ESX
PS C:\> $VMHost = Get-VMHost -ComputerName "ESXHost03"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"
Первая команда получает объект, представляющий узел VMware ESX с именем ESXHost03, и сохраняет этот объект в переменной $VMHost.
Вторая команда добавляет существующую виртуальную машину на ESXHost03 в VMM, указывая путь к файлу конфигурации виртуальной машины виртуальной машины.
Параметры
-JobGroup
Указывает идентификатор для ряда команд, которые выполняются как набор непосредственно перед выполнением последней команды, включающей тот же идентификатор группы заданий.
Свойства параметра
| Тип: | Guid |
| 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 |
-Path
Указывает путь к файлу конфигурации виртуальной машины для виртуальной машины, которую регистрирует этот командлет.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | 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 |
-VMHost
Указывает объект узла виртуальной машины. VMM поддерживает узлы Hyper-V, VMware ESX и Citrix XenServer.
Дополнительные сведения о каждом типе узла см. в командлете Add-SCVMHost .
Свойства параметра
| Тип: | Host |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.