Remove-SCVMHost

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 funkcji 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 na hostach XenServer.

• Host i serwer biblioteki. Jeśli ten komputer jest hostem funkcji 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 funkcji 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.

• Virtual Machines. Po usunięciu hosta host nie jest już zarządzany przez program VMM. Jednak żadne maszyny wirtualne na serwerze hosta nie zostaną usunięte ani usunięte z serwera. Wszystkie uruchomione maszyny wirtualne nie są zamykane. Chociaż 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 pyta 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 hosta z bazy danych programu VMM.

To polecenie cmdlet zwraca obiekt po pomyślnym 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 przechowywanie 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. W miarę przetwarzania tego polecenia $Credential dostarcza poświadczenia do remove-VMHost, a parametr Confirm 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 reprezentujące 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 . W miarę przetwarzania tego polecenia $Credential dostarcza poświadczenia do remove-VMHost, a parametr Confirm wyświetla monit 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 maszyna wirtualna VMHost03 została usunięta z bazy danych programu VMM. Poświadczenia nie są wymagane do wykonania tej operacji. Parametr Potwierdź wyświetla monit o potwierdzenie usunięcia 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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 zadania Restart-SCJob ma uprawnienia do wykonania 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.

Type:	VMMCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMHost

Określa obiekt hosta maszyny wirtualnej. Program VMM obsługuje hosty funkcji 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 .

Type:	Host
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Określa obiekt serwera programu VMM.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Linki powiązane

• 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