Remove-SCVMHost

Referenz

Modul:: VirtualMachineManager

Entfernt einen virtuellen Computerhost aus VMM.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCVMHost entfernt mindestens einen virtuellen Computerhost aus Virtual Machine Manager (VMM). Das Cmdlet Remove-SCVMHost funktioniert wie folgt:

Nur Hostserver. Wenn dieser Computer ein Hyper-V-Host ist, aber nicht auch ein Bibliotheksserver ist, wird das Hostobjekt aus der VMM-Datenbank entfernt, und die VMM-Agentsoftware wird vom physischen Hostserver deinstalliert.

Wenn der Host ein VMware ESX-Host oder ein Citrix XenServer-Host ist, wird das Hostobjekt aus der VMM-Datenbank entfernt. VMM installiert keinen Agent auf ESX-Hosts oder XenServer-Hosts.

Host- und Bibliotheksserver. Wenn dieser Computer ein Hyper-V-Host ist und auch ein Bibliotheksserver ist, entfernt dieser Befehl nur die Hostfunktionen, verlässt jedoch das Bibliotheksserverfeature. Das heißt, das Hostobjekt wird aus der VMM-Datenbank entfernt, aber die VMM-Agent-Software wird nicht vom physischen Server deinstalliert. Das Bibliothekserverobjekt bleibt in der Datenbank erhalten.

Wenn der Host ein ESX-Host ist, kann er nur als virtueller Computerhost in VMM funktionieren. Er kann nicht als Host und als Bibliothekserver verwendet werden.

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

Sie müssen keine Active Directory-Anmeldeinformationen bereitstellen, 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. Alle virtuellen Computer auf dem Hostserver werden jedoch nicht entfernt oder nicht vom Server zugeordnet. Ausgeführte virtuelle Maschinen werden nicht heruntergefahren. Obwohl die virtuellen Computer nicht mehr von VMM verwaltet werden, sind sie auf andere Weise nicht betroffen.
Erzwungene Entfernung. Sie können den Parameter Force mit dem Cmdlet Remove-SCVMHost verwenden, um einen virtuellen Computerhost aus VMM zu entfernen, wenn Sie keine entsprechenden Anmeldeinformationen zum Verwalten dieses Hosts haben oder wenn der VMM-Server nicht mehr mit diesem Host kommunizieren kann.

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

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf $True festgelegt) zurück oder gibt eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen eines bestimmten domänenbezogenen Hosts aus VMM

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

Der erste Befehl verwendet das Cmdlet "Get-Credential ", um Sie aufzufordern, einen Benutzernamen und ein Kennwort anzugeben und die bereitgestellten Anmeldeinformationen in der $Credential Variablen zu speichern. Die erforderlichen Anmeldeinformationen für diesen Vorgang sind ein Domänenkonto mit Administratorrechten, um einen windowsbasierten Hostserver zu entfernen, der mit einer Active Directory-Domäne aus VMM verbunden ist.

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

Der dritte Befehl entfernt das in $VMHost gespeicherte Hostobjekt. Da dieser Befehl verarbeitet wird, stellt $Credential Anmeldeinformationen für Remove-VMHost bereit, und der Parameter " Bestätigen " fordert Sie auf, zu bestätigen, dass Sie diesen Host aus VMM entfernen möchten.

Beispiel 2: Entfernen aller Hosts, die keine Knoten in einem Hostcluster von VMM sind

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, die Knoten in einem Hostcluster sind, wählt nur diese Objekte aus, die VMware ESX-Hosts, Umkreisnetzwerkhosts oder nicht vertrauenswürdige Domänenhosts darstellen, und entfernt dann diese Objekte aus VMM, wenn Sie bestätigen, dass Sie sie entfernen möchten. Zum Entfernen dieser Hosts sind keine Anmeldeinformationen erforderlich.

Der zweite Befehl fordert Sie auf, einen Benutzernamen und ein Kennwort für ein Konto mit Berechtigungen zum Entfernen von domänenbezogenen Windows-Hosts aus VMM anzugeben und Ihre Anmeldeinformationen in $Credential zu speichern.

Der letzte Befehl ruft alle domänenbezogenen Windows-basierten Hostobjekte ab, die nicht Teil eines Hostclusters sind, und übergibt die Objekte an das Cmdlet Remove-VMHost . Da dieser Befehl verarbeitet wird, stellt $Credential Ihre Anmeldeinformationen für Remove-VMHost bereit, und der Parameter bestätigen Sie, dass Sie diese Hosts aus VMM entfernen möchten.

Beispiel 3: Entfernen eines bestimmten Hosts, auf den Sie nicht mehr von VMM zugreifen können

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

Der erste Befehl ruft das Hostobjekt namens VMHost03 ab und speichert das Objekt in der $VMHost Variable.

Der zweite Befehl wechselt auf den Force-Parameter , um sicherzustellen, dass VMHost03 aus der VMM-Datenbank entfernt wird. Für diesen Vorgang sind keine Anmeldeinformationen erforderlich. Der Parameter " Bestätigen " fordert Sie auf, zu bestätigen, dass Sie diesen Host entfernen möchten.

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Gibt ein Anmeldeinformationenobjekt oder für einige Cmdlets ein Run As-Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder im Falle von Neustart-SCJob hat die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Weitere Informationen zum PSCredential-Objekt geben Sie Get-Help Get-Credentialein.

Geben Sie Get-Help New-SCRunAsAccountweitere Informationen zu "Ausführen als Konten" ein.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RemoveHostWithVMs

Weitere Informationen zum PSCredential-Objekt geben Sie Get-Help Get-Credentialein.

Geben Sie Get-Help New-SCRunAsAccountweitere Informationen zu "Ausführen als Konten" ein.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-VMHost

Gibt ein Hostobjekt für virtuelle Maschinen an. VMM unterstützt Hyper-V-Hosts, VMware ESX-Hosts und Citrix XenServer-Hosts.

Weitere Informationen zu jedem Hosttyp finden Sie im Add-SCVMHost-Cmdlet .

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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