Remove-SCVMHost

Module:

VirtualMachineManager

Hiermee verwijdert u een host van een virtuele machine uit 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>]

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 bibliotheekserverobject blijft in de database.

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

• Referenties. 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 uit VMM te verwijderen.

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

• Virtual 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 Force gebruiken met de cmdlet Remove-SCVMHost om een host voor virtuele machines 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 Force 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 wanneer verouderde hostrecords uit de VMM-database worden verwijderd.

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 host die lid is van een domein 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 $VMHost variabele.

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

Voorbeeld 2: Verwijder alle hosts die geen knooppunten in een hostcluster van VMM zijn

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 alle hosts uitgesloten die knooppunten in een hostcluster zijn, selecteert u alleen die objecten 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 windows-hostobjecten die lid zijn van een domein 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 voor Remove-VMHost op en de parameter Bevestigen wordt u gevraagd 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 over op de parameter Force om ervoor te zorgen dat VMHost03 uit de VMM-database wordt verwijderd. Referenties zijn niet nodig voor deze bewerking. De parameter Bevestigen vraagt u om te bevestigen dat u deze host wilt verwijderen.

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

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 gemachtigd is om deze actie uit te voeren. Of, in het geval van Restart-SCJob, is gemachtigd om een opnieuw opgestarte taak te voltooien.

Typ voor meer informatie over het PSCredential-objectGet-Help Get-Credential.

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

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveHostWithVMs

Typ voor meer informatie over het PSCredential-objectGet-Help Get-Credential.

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMHost

Hiermee geeft u een hostobject voor virtuele machines op. 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
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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