Delen via

Remove-SCVMHostGroup

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een hostgroep uit VMM.

Syntax

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

Description

De cmdlet Remove-SCVMHostGroup verwijdert 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 aan deze groep 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 verwijdert u het hostgroepobject dat is opgeslagen in de $HostGroup variabele.

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

-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

-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

-VMHostGroup

Hiermee geeft u een hostgroepobject voor de virtuele machine op.

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

Notities

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