Remove-SCVMHost

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 kein 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 Hostfunktionalität, 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 vom Server getrennt. 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 von 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 Parameter Force angeben, fragt VMM keine 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 veraltete Hostdatensätze aus der VMM-Datenbank entfernt werden.

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

Beispiele

Beispiel 1: Entfernen eines bestimmten domänengebundenen 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 Windows-basierten Hostserver zu entfernen, der einer Active Directory-Domäne von VMM beigetreten ist.

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

Der dritte Befehl entfernt das hostobjekt, das in $VMHost gespeichert ist. 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 sind, aus 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

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 diese Objekte dann von 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 von VMM anzugeben und Ihre Anmeldeinformationen in $Credential zu speichern.

Der letzte Befehl ruft alle in der Domäne eingebundenen 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 " fordert Sie auf, zu bestätigen, 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 mit dem Namen VMHost03 ab und speichert das Objekt in der $VMHost Variablen.

Der zweite Befehl wechselt auf den Parameter Force , 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 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.

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 Anmeldeinformationsobjekt 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 Restart-SCJob hat die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential.

Weitere Informationen zum Ausführen als Konten geben Sie Get-Help New-SCRunAsAccount.

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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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

Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential.

Weitere Informationen zum Ausführen als Konten geben Sie Get-Help New-SCRunAsAccount.

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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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

Ähnliche Themen

• 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