Remove-SCVMHost

Module:

VirtualMachineManager

Hiermee verwijdert u een virtuele-machinehost 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 hosts voor virtuele machines 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 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 aanwezig 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.

• 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 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 Force opgeeft, vraagt of controleert VMM niet op referenties, noch probeert VMM 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 (met de eigenschap MarkedForDeletion ingesteld op $True) of retourneert een foutbericht bij 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 $VMHost variabele.

Met de derde opdracht wordt het hostobject verwijderd dat is opgeslagen in $VMHost. Als deze opdracht wordt verwerkt, geeft $Credential referenties aan Remove-VMHosten wordt u gevraagd om te bevestigen dat u deze host uit VMM wilt verwijderen.

Voorbeeld 2: verwijder alle hosts die geen knooppunten in een hostcluster zijn uit 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 alle hosts uitgesloten die knooppunten in een hostcluster zijn, worden alleen de objecten geselecteerd die VMware ESX-hosts, perimeternetwerkhosts of niet-vertrouwde domeinhosts vertegenwoordigen en worden deze objecten vervolgens uit VMM verwijderd 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 . Wanneer deze opdracht wordt verwerkt, geeft $Credential uw referenties voor Remove-VMHost op en wordt u gevraagd om te bevestigen dat u deze hosts uit VMM wilt verwijderen.

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

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

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

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 de virtuele machine 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