Remove-SCVMHost

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

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 jest usuwany z bazy danych programu VMM, a oprogramowanie agenta programu VMM jest odinstalowywane z fizycznego serwera hosta.

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

• Serwer hosta i biblioteki. Jeśli ten komputer jest hostem Hyper-V i jest również serwerem biblioteki, to polecenie usuwa tylko funkcję 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 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 żadne maszyny wirtualne na serwerze hosta nie zostaną usunięte ani skojarzone z serwerem. Wszystkie uruchomione maszyny wirtualne nie są zamykane. Mimo że maszyny wirtualne nie są już zarządzane przez program VMM, nie ma na nie wpływu żaden inny sposób.
• Wymuszone usunięcie. Parametru Force można użyć 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 prosi o poświadczenia ani nie sprawdza ich poświadczeń, a program VMM nie będzie próbował nawiązać połączenia z hostem i odinstalować agenta programu VMM. W związku z tym użycie parametru Force jest zalecane tylko w przypadku usuwania starych rekordów hosta z bazy danych programu VMM.

To polecenie cmdlet zwraca obiekt w przypadku powodzenia (z właściwością MarkedForDeletion ustawioną na wartość $True) lub zwraca komunikat o błędzie w przypadku niepowodzenia.

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 w celu wyświetlenia monitu o podanie nazwy użytkownika i hasła oraz przechowuje podane poświadczenia w zmiennej $Credential. Poświadczenia wymagane do wykonania tej operacji to konto domeny z uprawnieniami administratora do usunięcia serwera hosta opartego na systemie Windows przyłączonego do domeny usługi Active Directory z programu VMM.

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

Trzecie polecenie usuwa obiekt hosta przechowywany w $VMHost. Podczas przetwarzania tego polecenia $Credential udostępnia poświadczenia do Remove-VMHost, a parametr Confirm monituje o potwierdzenie, że chcesz usunąć tego hosta 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 niezaufane hosty domeny, 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 monituje o podanie nazwy użytkownika i hasła dla konta z uprawnieniami do usuwania przyłączonych do domeny hostów systemu Windows z programu VMM i przechowuje poświadczenia w $Credential.

Ostatnie polecenie pobiera wszystkie przyłączone do domeny obiekty hosta oparte na systemie Windows, które nie są częścią klastra hostów, i przekazuje je do polecenia cmdlet Remove-VMHost . Podczas przetwarzania tego polecenia $Credential podaje poświadczenia do Remove-VMHost, a parametr Confirm monituje o potwierdzenie, że chcesz usunąć te hosty 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 zapisuje go w zmiennej $VMHost.

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

Uwaga: Parametru Force można użyć do usunięcia 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.

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.