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

Mit dem Cmdlet Remove-SCVMHost werden ein oder mehrere Hosts für virtuelle Maschinen aus Virtual Machine Manager (VMM) entfernt. Das Cmdlet Remove-SCVMHost funktioniert wie folgt:

• Nur Hostserver. Wenn es sich bei diesem Computer um einen Hyper-V Host, aber nicht auch um einen Bibliothekserver handelt, wird das Hostobjekt aus der VMM-Datenbank entfernt, und die VMM-Agent-Software wird vom physischen Hostserver deinstalliert.

Wenn es sich bei dem Host um einen VMware ESX-Host oder einen Citrix XenServer-Host handelt, wird das Hostobjekt aus der VMM-Datenbank entfernt. VMM installiert keinen Agent auf ESX-Hosts oder XenServer-Hosts.

• Host- und Bibliothekserver. Wenn es sich bei diesem Computer um einen Hyper-V Host und auch um einen Bibliothekserver handelt, wird mit diesem Befehl nur die Hostfunktionalität entfernt, die Bibliothekserverfunktion bleibt jedoch an Ort und Stelle. Das heißt, das Hostobjekt wird aus der VMM-Datenbank entfernt, aber die VMM-Agentsoftware wird nicht vom physischen Server deinstalliert. Das Bibliothekserverobjekt verbleibt in der Datenbank.

Wenn es sich bei dem Host um einen ESX-Host handelt, kann er nur als Host für virtuelle Maschinen in VMM fungieren. Es kann sich nicht sowohl um einen Host als auch um einen Bibliothekserver handeln.

• Beglaubigungsschreiben. Wenn ein Hyper-V Host mit einer Active Directory-Domäne verbunden ist, müssen Sie die Anmeldeinformationen für ein Konto mit den entsprechenden Berechtigungen angeben, um diesen Hostcomputer aus VMM zu entfernen.

Sie müssen keine Active Directory-Anmeldeinformationen angeben, um einen Umkreisnetzwerkhost, einen ESX-Host oder einen XenServer-Host aus VMM zu entfernen.

• Virtuelle Computer. Wenn Sie einen Host entfernen, wird der Host nicht mehr von VMM verwaltet. Virtuelle Maschinen auf dem Hostserver werden jedoch nicht entfernt oder vom Server getrennt. Laufende virtuelle Maschinen werden nicht heruntergefahren. Obwohl die virtuellen Maschinen nicht mehr von VMM verwaltet werden, sind sie nicht anderweitig betroffen.
• Erzwungene Entfernung. Sie können den Force-Parameter mit dem Cmdlet Remove-SCVMHost verwenden, um einen VM-Host aus VMM zu entfernen, wenn Sie nicht über die entsprechenden Anmeldeinformationen zum Verwalten dieses Hosts verfügen oder wenn der VMM-Server nicht mehr mit diesem Host kommunizieren kann.

Wenn Sie den force-Parameter angeben, fragt VMM weder nach Anmeldeinformationen noch sucht VMM nach Anmeldeinformationen, und VMM versucht auch nicht, eine Verbindung mit dem Host herzustellen und den VMM-Agent zu deinstallieren. Daher wird die Verwendung des Force-Parameters nur empfohlen, wenn veraltete Hostdatensätze aus der VMM-Datenbank entfernt werden.

Dieses Cmdlet gibt das Objekt bei Erfolg zurück (wobei die Eigenschaft MarkedForDeletion auf $True festgelegt ist) oder gibt eine Fehlermeldung zurück, wenn ein Fehler auftritt.

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

Im ersten Befehl werden Sie mit dem Cmdlet Get-Credential aufgefordert, einen Benutzernamen und ein Kennwort einzugeben, und die angegebenen Anmeldeinformationen werden in der Variablen $Credential gespeichert. Die erforderlichen Anmeldeinformationen für diesen Vorgang sind ein Domänenkonto mit Administratorrechten zum Entfernen eines Windows-basierten Hostservers, der mit einer Active Directory-Domäne verbunden ist, aus VMM.

Der zweite Befehl ruft das Hostobjekt mit dem Namen VMHost01 ab und speichert das Objekt in der Variablen $VMHost.

Mit dem dritten Befehl wird das in $VMHost gespeicherte Hostobjekt entfernt. Während der Verarbeitung dieses Befehls stellt $Credential Anmeldeinformationen für Remove-VMHost bereit, und der Parameter Confirm fordert Sie auf, zu bestätigen, dass Sie diesen Host aus VMM entfernen möchten.

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

Der erste Befehl ruft alle Hostobjekte ab, schließt alle Hosts aus, bei denen es sich um Knoten in einem Hostcluster handelt, wählt nur die Objekte aus, die VMware ESX-Hosts, Umkreisnetzwerkhosts oder nicht vertrauenswürdige Domänenhosts darstellen, und entfernt diese Objekte dann aus VMM, wenn Sie bestätigen, dass Sie sie entfernen möchten. Anmeldeinformationen sind nicht erforderlich, um diese Hosts zu entfernen.

Der zweite Befehl fordert Sie auf, einen Benutzernamen und ein Kennwort für ein Konto mit Berechtigungen zum Entfernen von in die Domäne eingebundenen Windows-Hosts aus VMM anzugeben, und speichert Ihre Anmeldeinformationen in $Credential.

Mit dem letzten Befehl werden alle in die Domäne eingebundenen Windows-basierten Hostobjekte abgerufen, die nicht Teil eines Hostclusters sind, und die Objekte an das Cmdlet Remove-VMHost übergeben. Während der Verarbeitung dieses Befehls gibt $Credential Ihre Anmeldeinformationen für Remove-VMHost an, und der Parameter Confirm fordert Sie auf, zu bestätigen, dass Sie diese Hosts aus VMM entfernen möchten.

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

Der erste Befehl ruft das Hostobjekt mit dem Namen VMHost03 ab und speichert das Objekt in der Variablen $VMHost.

Mit dem zweiten Befehl wird der Parameter Force aktiviert, um sicherzustellen, dass VMHost03 aus der VMM-Datenbank entfernt wird. Für diesen Vorgang sind keine Anmeldeinformationen erforderlich. Der Parameter Confirm fordert Sie auf, zu bestätigen, dass Sie diesen Host entfernen möchten.

Hinweis: Sie können den Parameter Force verwenden, um einen Host aus VMM zu entfernen, wenn Sie nicht über die Anmeldeinformationen für diesen Host verfügen oder wenn der VMM-Server nicht mehr mit diesem Host kommunizieren kann.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.