Remove-SCVMHost

Module:

VirtualMachineManager

Hiermee verwijdert u een virtuele-machinehost uit VMM.

Syntaxis

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

Description

De cmdlet Remove-SCVMHost verwijdert een of meer virtuele-machinehosts uit Virtual Machine Manager (VMM). De cmdlet Remove-SCVMHost werkt als volgt:

• Alleen hostserver. Als deze computer een Hyper-V host is, maar geen bibliotheekserver is, wordt het hostobject verwijderd uit de VMM-database en wordt de VMM-agentsoftware verwijderd van de fysieke hostserver.

Als de host een VMware ESX-host of een Citrix XenServer-host is, wordt het hostobject verwijderd uit de VMM-database. VMM installeert geen agent op ESX-hosts of XenServer-hosts.

• Host- en bibliotheekserver. Als deze computer een Hyper-V host is en ook een bibliotheekserver is, verwijdert deze opdracht alleen de hostfunctionaliteit, maar blijft de bibliotheekserverfunctie aanwezig. Dat wil gezegd: het hostobject wordt verwijderd uit de VMM-database, maar de VMM-agentsoftware wordt niet verwijderd van de fysieke server. Het object bibliotheekserver blijft in de database.

Als de host een ESX-host is, kan deze alleen functioneren als host van een virtuele machine in VMM. Het kan niet zowel een host als een bibliotheekserver zijn.

• Geloofsbrief. Als een Hyper-V host is gekoppeld aan een Active Directory-domein, moet u referenties opgeven voor een account met de juiste machtigingen om die hostcomputer te verwijderen uit VMM.

U hoeft geen Active Directory-referenties op te geven om een perimeternetwerkhost, een ESX-host of een XenServer-host uit VMM te verwijderen.

• Virtuele machines. Wanneer u een host verwijdert, wordt de host niet meer beheerd door VMM. Virtuele machines op de hostserver worden echter niet verwijderd of ontkoppeld van de server. Actieve virtuele machines worden niet afgesloten. Hoewel de virtuele machines niet meer worden beheerd door VMM, worden ze op geen enkele andere manier beïnvloed.
• Gedwongen verwijdering. U kunt de parameter Forceren gebruiken met de cmdlet Remove-SCVMHost om een virtuele-machinehost uit VMM te verwijderen wanneer u niet over de juiste referenties beschikt om die host te beheren of wanneer de VMM-server niet meer met die host kan communiceren.

Wanneer u de parameter Forceren opgeeft, vraagt of controleert VMM niet op referenties en probeert VMM geen verbinding te maken met de host en de VMM-agent te verwijderen. Daarom wordt het gebruik van de parameter Force alleen aanbevolen bij het verwijderen van verouderde hostrecords uit de VMM-database.

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op $True) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een specifieke domein-gekoppelde host verwijderen uit VMM

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

De eerste opdracht maakt gebruik van de cmdlet Get-Credential om u te vragen een gebruikersnaam en wachtwoord op te geven en de opgegeven referenties op te slaan in de $Credential variabele. De vereiste referenties voor deze bewerking zijn een domeinaccount met beheerdersrechten voor het verwijderen van een Windows-hostserver die is gekoppeld aan een Active Directory-domein van VMM.

Met de tweede opdracht wordt het hostobject met de naam VMHost01 opgehaald en wordt het object opgeslagen in de variabele $VMHost.

Met de derde opdracht wordt het hostobject verwijderd dat is opgeslagen in $VMHost. Terwijl deze opdracht wordt verwerkt, geeft $Credential referenties voor Remove-VMHost-en geeft de Bevestig parameter u om te bevestigen dat u deze host wilt verwijderen uit VMM.

Voorbeeld 2: Verwijder alle hosts die geen knooppunten in een hostcluster zijn van 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

Met de eerste opdracht worden alle hostobjecten opgehaald, worden hosts uitgesloten die knooppunten in een hostcluster zijn, worden alleen de objecten geselecteerd die VMware ESX-hosts, perimeternetwerkhosts of niet-vertrouwde domeinhosts vertegenwoordigen en verwijdert u deze objecten vervolgens uit VMM als u bevestigt dat u ze wilt verwijderen. Referenties zijn niet vereist om deze hosts te verwijderen.

Met de tweede opdracht wordt u gevraagd een gebruikersnaam en wachtwoord op te geven voor een account met machtigingen voor het verwijderen van Windows-hosts die lid zijn van een domein uit VMM en slaat u uw referenties op in $Credential.

Met de laatste opdracht worden alle op een domein gekoppelde Windows-hostobjecten opgehaald die geen deel uitmaken van een hostcluster en worden de objecten doorgegeven aan de cmdlet Remove-VMHost. Terwijl deze opdracht wordt verwerkt, geeft $Credential uw referenties op voor Remove-VMHost-, en de Bevestig parameterprompt u om te bevestigen dat u deze hosts wilt verwijderen uit VMM.

Voorbeeld 3: Een specifieke host verwijderen waartoe u geen toegang meer hebt vanuit VMM

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

Met de eerste opdracht wordt het hostobject met de naam VMHost03 opgehaald en wordt het object opgeslagen in de $VMHost variabele.

Met de tweede opdracht schakelt u de parameter Force af om ervoor te zorgen dat VMHost03 uit de VMM-database wordt verwijderd. Referenties zijn niet nodig voor deze bewerking. De Bevestig parameter vraagt u om te bevestigen dat u deze host wilt verwijderen.

Opmerking: u kunt de parameter Forceren gebruiken om een host uit VMM te verwijderen wanneer u niet over de referenties voor die host beschikt of wanneer de VMM-server niet meer met die host kan communiceren.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Credential

Hiermee geeft u een referentieobject of, voor sommige cmdlets, een Uitvoeren als-accountobject met de gebruikersnaam en het wachtwoord van een account dat is gemachtigd om deze actie uit te voeren. Of, in het geval van Restart-SCJob, is gemachtigd om een opnieuw gestarte taak te voltooien.

Typ Get-Help Get-Credentialvoor meer informatie over het object PSCredential.

Typ Get-Help New-SCRunAsAccountvoor meer informatie over Uitvoeren als-accounts.

Type:	VMMCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:	Guid
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RemoveHostWithVMs

Typ Get-Help Get-Credentialvoor meer informatie over het object PSCredential.

Typ Get-Help New-SCRunAsAccountvoor meer informatie over Uitvoeren als-accounts.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine. VMM ondersteunt Hyper-V hosts, VMware ESX-hosts en Citrix XenServer-hosts.

Zie de cmdlet Add-SCVMHost voor meer informatie over elk type host.

Type:	Host
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:	ServerConnection
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Verwante koppelingen

• 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