Remove-SCVMHost
Удаляет узел виртуальной машины из VMM.
Синтаксис
NormalRemoval (по умолчанию)
Remove-SCVMHost
[-VMHost] <Host>
[-VMMServer <ServerConnection>]
[-Credential <VMMCredential>]
[-RemoveHostWithVMs]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ForceRemoval
Remove-SCVMHost
[-VMHost] <Host>
[-VMMServer <ServerConnection>]
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Remove-SCVMHost удаляет один или несколько узлов виртуальных машин из Virtual Machine Manager (VMM). Командлет Remove-SCVMHost работает следующим образом:
- Только хост-сервер. Если этот компьютер является Hyper-V узлом, но не является сервером библиотеки, объект узла удаляется из базы данных VMM, а программное обеспечение агента VMM удаляется с физического сервера.
Если узел является узлом VMware ESX или узлом Citrix XenServer, объект узла удаляется из базы данных VMM. VMM не устанавливает агент на хосты ESX или XenServer.
- Хост и сервер библиотеки. Если этот компьютер является Hyper-V хостом и также сервером библиотеки, эта команда удаляет только функциональность хоста, но оставляет функцию сервера библиотеки. Это означает, что объект узла удаляется из базы данных VMM, но программное обеспечение агента VMM не удаляется с физического сервера. Объект сервера библиотеки остается в базе данных.
Если узел является узлом ESX, он может функционировать только как узел виртуальной машины в VMM. Он не может быть одновременно хостом и сервером библиотеки.
- Верительные грамоты. Если Hyper-V узел присоединен к домену Active Directory, необходимо предоставить учетные данные для учетной записи с соответствующими разрешениями для удаления этого хост-компьютера из VMM.
Для удаления узла демилитаризованной зоны, узла ESX или узла XenServer из VMM не требуется предоставлять учетные данные Active Directory.
- машинах Azure. При удалении узла он больше не управляется VMM. Однако виртуальные машины на сервере узла не будут удалены или отключены от сервера. Все работающие виртуальные машины не завершают работу. Несмотря на то, что виртуальные машины больше не управляются VMM, они никак не подвержены влиянию.
- Принудительное удаление. Вы можете использовать параметр Force с командлетом Remove-SCVMHost для удаления узла виртуальной машины из VMM, если у вас нет соответствующих учетных данных для управления этим узлом или когда сервер VMM больше не может взаимодействовать с этим узлом.
При указании параметра Force VMM не запрашивает и не проверяет учетные данные, а также не пытается подключиться к узлу и удалить агент VMM. Следовательно, использование параметра Force рекомендуется использовать только при удалении устаревших записей узла сети из базы данных VMM.
Этот командлет возвращает объект при успешном выполнении (со свойством MarkedForDeletion, имеющим значение $True) или возвращает сообщение об ошибке при сбое.
Примеры
Пример 1: Удаление определенного узла, присоединенного к домену, из VMM
PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm
Первая команда использует командлет Get-Credential для запроса на ввод имени пользователя и пароля и сохраняет предоставленные учетные данные в переменной $Credential. Для этой операции требуется учетная запись домена с правами администратора для удаления хост-сервера на базе Windows, присоединенного к домену Active Directory из VMM.
Вторая команда получает объект host с именем VMHost01 и сохраняет объект в переменной $VMHost.
Третья команда удаляет основной объект, хранящийся в $VMHost. По мере обработки этой команды $Credential предоставляет учетные данные для Remove-VMHost, а параметр Confirm предлагает вам подтвердить, что вы хотите удалить этот узел из VMM.
Пример 2: Удалите из VMM все узлы, которые не являются узлами в кластере узлов
PS C:\> Get-SCVMHost | where {$_.HostCluster -eq $NULL} | where {$_.VirtualizationPlatform -eq "VMwareESX" -or $_.PerimeterNetworkHost -eq 1 -or $_.NonTrustedDomainHost -eq 1} | Remove-SCVMHost -Confirm
PS C:\> $Credential = Get-Credential
PS C:\> Get-VMHost | where {$_.HostCluster -eq $NULL -and $_.VirtualizationPlatform -ne "VMwareESX" -and $_.PerimeterNetworkHost -eq 0 -and $_.NonTrustedDomainHost -eq 0} | Remove-VMHost -Credential $Credential -Confirm
Первая команда получает все объекты узлов, исключает все узлы, которые являются узлами в кластере узлов, выбирает только те объекты, которые представляют узлы VMware ESX, узлы сети периметра или недоверенные узлы домена, а затем удаляет эти объекты из VMM, если вы подтверждаете их удаление. Для удаления этих узлов не требуются учетные данные.
Вторая команда запрашивает у вас имя пользователя и пароль для учетной записи с разрешениями на удаление присоединенных к домену узлов Windows из VMM, и сохраняет ваши учетные данные в $Credential.
Последняя команда получает все присоединенные к домену объекты узла на основе Windows, которые не являются частью кластера узлов, и передает эти объекты командлету Remove-VMHost . По мере обработки этой команды $Credential предоставляет ваши учетные данные Remove-VMHost, а параметр Confirm предлагает вам подтвердить, что вы хотите удалить эти узлы из VMM.
Пример 3: Удалите определенный узел, к которому вы больше не можете получить доступ из VMM
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm
Первая команда получает объект host с именем VMHost03 и сохраняет объект в переменной $VMHost.
Вторая команда включает параметр Force , чтобы гарантировать, что VMHost03 будет удален из базы данных VMM. Учетные данные для этой операции не требуются. Параметр Confirm предлагает вам подтвердить, что вы действительно хотите удалить этот узел сети.
Примечание: Вы можете использовать параметр Принудительно для удаления узла из VMM, если у вас нет учетных данных для этого узла или когда сервер VMM больше не может взаимодействовать с этим узлом.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает объект учетных данных или, для некоторых командлетов, объект учетной записи «Запуск от имени», содержащий имя пользователя и пароль учетной записи, имеющей разрешение на выполнение этого действия. Или, в случае Restart-SCJob, имеет разрешение на выполнение перезапущенной задачи.
Дополнительные сведения о объекте PSCredential введите Get-Help Get-Credential.
Для получения дополнительной информации об учетных записях запуска от имени введите Get-Help New-SCRunAsAccount.
Свойства параметра
| Тип: | VMMCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NormalRemoval
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ForceRemoval
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-PROTipID
Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RemoveHostWithVMs
Дополнительные сведения о объекте PSCredential введите Get-Help Get-Credential.
Для получения дополнительной информации об учетных записях запуска от имени введите Get-Help New-SCRunAsAccount.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
NormalRemoval
| 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 |
-VMMServer
Указывает объект сервера VMM.
Свойства параметра
| Тип: | 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.