Udostępnij za pośrednictwem

Remove-SCVMHost

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa hosta maszyny wirtualnej z programu VMM.

Składnia

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>]

Opis

Polecenie cmdlet Remove-SCVMHost usuwa co najmniej jeden host maszyny wirtualnej z programu Virtual Machine Manager (VMM). Polecenie cmdlet remove-SCVMHost działa w następujący sposób:

  • Tylko serwer hosta. Jeśli ten komputer jest hostem Hyper-V, ale nie jest również serwerem biblioteki, obiekt hosta zostanie usunięty z bazy danych programu VMM, a oprogramowanie agenta programu VMM zostanie odinstalowane z serwera hosta fizycznego.

Jeśli host jest hostem VMware ESX lub hostem Citrix XenServer, obiekt hosta zostanie usunięty z bazy danych programu VMM. Program VMM nie instaluje agenta na hostach ESX ani hostach XenServer.

  • Host i serwer biblioteki. Jeśli ten komputer jest hostem Hyper-V i jest również serwerem biblioteki, to polecenie usuwa tylko funkcje hosta, ale pozostawia funkcję serwera biblioteki. Oznacza to, że obiekt hosta jest usuwany z bazy danych programu VMM, ale oprogramowanie agenta programu VMM nie jest odinstalowywane z serwera fizycznego. Obiekt serwera biblioteki pozostaje w bazie danych.

Jeśli host jest hostem ESX, może działać tylko jako host maszyny wirtualnej w programie VMM. Nie może to być zarówno host, jak i serwer biblioteki.

  • Poświadczenia. Jeśli host Hyper-V jest przyłączony do domeny usługi Active Directory, należy podać poświadczenia dla konta z odpowiednimi uprawnieniami, aby usunąć ten komputer hosta z programu VMM.

Nie trzeba podawać poświadczeń usługi Active Directory, aby usunąć hosta sieci obwodowej, hosta ESX lub hosta XenServer z programu VMM.

  • Maszyny wirtualne. Po usunięciu hosta host nie jest już zarządzany przez program VMM. Jednak wszystkie maszyny wirtualne na serwerze hosta nie zostaną usunięte ani usunięte z serwera. Wszystkie uruchomione maszyny wirtualne nie są zamykane. Mimo że maszyny wirtualne nie są już zarządzane przez program VMM, nie mają wpływu na nie w żaden inny sposób.
  • Wymuszone usunięcie. Możesz użyć parametru Force z poleceniem cmdlet Remove-SCVMHost, aby usunąć hosta maszyny wirtualnej z programu VMM, gdy nie masz odpowiednich poświadczeń do zarządzania tym hostem lub gdy serwer programu VMM nie może już komunikować się z tym hostem.

Po określeniu parametru Force program VMM nie ani nie sprawdza poświadczeń, ani nie podejmie próby nawiązania połączenia z hostem i odinstalowania agenta programu VMM. W związku z tym użycie parametru Force jest zalecane tylko w przypadku usuwania nieaktualnych rekordów hostów z bazy danych programu VMM.

To polecenie cmdlet zwraca obiekt po powodzeniu (z właściwością MarkedForDeletion ustawioną na $True) lub zwraca komunikat o błędzie po awarii.

Przykłady

Przykład 1: Usuwanie określonego hosta przyłączonego do domeny z programu VMM

PS C:\> $Credential = Get-Credential
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Remove-SCVMHost -VMHost $VMHost -Credential $Credential -Confirm

Pierwsze polecenie używa polecenia cmdlet Get-Credential, aby wyświetlić monit o podanie nazwy użytkownika i hasła oraz zapisanie podanych poświadczeń w zmiennej $Credential. Wymagane poświadczenia dla tej operacji to konto domeny z uprawnieniami administratora w celu usunięcia serwera hosta z systemem Windows przyłączonego do domeny usługi Active Directory z programu VMM.

Drugie polecenie pobiera obiekt hosta o nazwie VMHost01 i przechowuje obiekt w zmiennej $VMHost.

Trzecie polecenie usuwa obiekt hosta przechowywany w $VMHost. Ponieważ to polecenie jest przetwarzane, $Credential udostępnia poświadczenia Remove-VMHost, a Potwierdź parametr monituje o potwierdzenie, że chcesz usunąć ten host z programu VMM.

Przykład 2. Usuwanie wszystkich hostów, które nie są węzłami w klastrze hostów z programu 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

Pierwsze polecenie pobiera wszystkie obiekty hosta, wyklucza wszystkie hosty, które są węzłami w klastrze hostów, wybiera tylko te obiekty, które reprezentują hosty VMware ESX, hosty sieci obwodowej lub hosty domen innych niż zaufane, a następnie usuwa te obiekty z programu VMM, jeśli potwierdzisz, że chcesz je usunąć. Poświadczenia nie są wymagane do usunięcia tych hostów.

Drugie polecenie wyświetla monit o podanie nazwy użytkownika i hasła dla konta z uprawnieniami do usuwania hostów systemu Windows przyłączonych do domeny z programu VMM i przechowywania poświadczeń w $Credential.

Ostatnie polecenie pobiera wszystkie obiekty hosta oparte na domenie z systemem Windows, które nie są częścią klastra hostów i przekazuje obiekty do polecenia cmdlet Remove-VMHost. Ponieważ to polecenie jest przetwarzane, $Credential udostępnia poświadczenia Remove-VMHost, a Potwierdź parametr monituje o potwierdzenie, że chcesz usunąć te hosty z programu VMM.

Przykład 3: Usuwanie określonego hosta, do którego nie można już uzyskać dostępu z programu VMM

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

Pierwsze polecenie pobiera obiekt hosta o nazwie VMHost03 i przechowuje obiekt w zmiennej $VMHost.

Drugie polecenie włącza parametr Force, aby upewnić się, że host VMHost03 został usunięty z bazy danych programu VMM. Poświadczenia nie są wymagane do wykonania tej operacji. Potwierdź parametr monituje o potwierdzenie, że chcesz usunąć tego hosta.

Uwaga: możesz użyć parametru Force, aby usunąć hosta z programu VMM, gdy nie masz poświadczeń dla tego hosta lub gdy serwer programu VMM nie może już komunikować się z tym hostem.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa obiekt poświadczeń lub, dla niektórych poleceń cmdlet, obiekt konta Uruchom jako, który zawiera nazwę użytkownika i hasło konta, które ma uprawnienia do wykonania tej akcji. Lub w przypadku Restart-SCJobma uprawnienia do ukończenia ponownie uruchomionego zadania.

Aby uzyskać więcej informacji na temat obiektu PSCredential, wpisz Get-Help Get-Credential.

Aby uzyskać więcej informacji na temat kont Uruchom jako, wpisz Get-Help New-SCRunAsAccount.

Typ:VMMCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RemoveHostWithVMs

Aby uzyskać więcej informacji na temat obiektu PSCredential, wpisz Get-Help Get-Credential.

Aby uzyskać więcej informacji na temat kont Uruchom jako, wpisz Get-Help New-SCRunAsAccount.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VMHost

Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty Hyper-V, hosty VMware ESX i hosty Citrix XenServer.

Aby uzyskać więcej informacji na temat każdego typu hosta, zobacz polecenie cmdlet add-SCVMHost .

Typ:Host
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMMServer

Określa obiekt serwera programu VMM.

Typ:ServerConnection
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False