Delen via

Remove-SCVMHostGroup

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een hostgroep uit VMM.

Syntaxis

Remove-SCVMHostGroup
      [-VMHostGroup] <HostGroup>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Met de cmdlet Remove-SCVMHostGroup verwijdert u een of meer hostgroepobjecten uit de VMM-database (Virtual Machine Manager). Een hostgroep kan niet worden verwijderd als deze is gekoppeld aan een privécloud, als er hosts aan de groep zijn toegewezen of als de onderliggende hostgroep hosts heeft toegewezen. Met deze cmdlet worden onderliggende hostgroepen verwijderd als de hostgroep en de onderliggende hostgroepen geen hosts voor virtuele machines bevatten.

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: De opgegeven hostgroep verwijderen

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup02"
PS C:\> Remove-SCVMHostGroup -VMHostGroup $HostGroup

Met de eerste opdracht wordt de hostgroep met de naam HostGroup02 opgeslagen in de $HostGroup variabele.

Met de tweede opdracht wordt het hostgroepobject verwijderd dat is opgeslagen in de $HostGroup variabele.

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

-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

-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

-VMHostGroup

Hiermee geeft u een hostgroepobject voor de virtuele machine op.

Type:HostGroup
Position:0
Default value:None
Vereist:True
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

Notities

  • Hiervoor is een VMM-hostgroepobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVMHostGroup.