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.