Remove-SCVMHost

Модуль:

VirtualMachineManager

Удаляет узел виртуальной машины из VMM.

Синтаксис

Remove-SCVMHost
      [-VMHost] <Host>
      [-VMMServer <ServerConnection>]
      [-Credential <VMMCredential>]
      [-RemoveHostWithVMs]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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.

Не нужно предоставлять учетные данные Active Directory для удаления узла сети периметра, узла ESX или узла XenServer из VMM.

• Виртуальные машины. При удалении узла узел больше не управляется VMM. Тем не менее все виртуальные машины на сервере узла не будут удалены или отсоединены от сервера. Все запущенные виртуальные машины не завершаются. Хотя виртуальные машины больше не управляются VMM, они не затрагиваются другим способом.
• Принудительное удаление. Вы можете использовать параметр с командлет ом Remove-SCVMHost 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.

Вторая команда получает объект узла с именем 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, а параметр "Подтверждение" запрашивает подтверждение удаления этих узлов из VMM.

Пример 3. Удаление определенного узла, к которому больше не удается получить доступ из VMM

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Force -Confirm

Первая команда получает объект узла с именем VMHost03 и сохраняет объект в переменной $VMHost.

Вторая команда переключается на параметр Force, чтобы убедиться, что VMHost03 удален из базы данных VMM. Учетные данные не требуются для этой операции. Параметр подтверждение запрашивает подтверждение удаления этого узла.

Примечание. Чтобы удалить узел из VMM, можно использовать параметр , если у вас нет учетных данных для этого узла или когда сервер VMM больше не может взаимодействовать с этим узлом.

Параметры

-Confirm

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает объект учетных данных или для некоторых командлетов объект учетной записи запуска от имени, содержащий имя пользователя и пароль учетной записи с разрешением на выполнение этого действия. Или, в случае перезапуск-SCJob, имеет разрешение на завершение перезапуска задачи.

Дополнительные сведения о объекте PSCredential введите .

Дополнительные сведения о учетных записях запуска от имени введите Get-Help New-SCRunAsAccount.

Тип:	VMMCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Force

Принудительно выполняется команда без запроса подтверждения пользователя.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-JobVariable

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

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PROTipID

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

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RemoveHostWithVMs

Дополнительные сведения о объекте PSCredential введите .

Дополнительные сведения о учетных записях запуска от имени введите Get-Help New-SCRunAsAccount.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RunAsynchronously

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

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMHost

Указывает объект узла виртуальной машины. VMM поддерживает узлы Hyper-V, узлы VMware ESX и узлы Citrix XenServer.

Дополнительные сведения о каждом типе узла см. в командлете Add-SCVMHost.

Тип:	Host
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-VMMServer

Указывает объект сервера VMM.

Тип:	ServerConnection
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Связанные ссылки

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Get-SCVMHost
• Move-SCVMHost
• New-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost