Share via

Remove-SCVMHostGroup

  • Referenz
Modul:
VirtualMachineManager

Entfernt eine Hostgruppe aus VMM.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCVMHostGroup entfernt eine oder mehrere Hostgruppenobjekte aus der Virtual Machine Manager -Datenbank (VMM). Eine Hostgruppe kann nicht gelöscht werden, wenn sie einer privaten Cloud zugeordnet ist, wenn sie Hosts zugewiesen hat oder der untergeordneten Hostgruppe hosts zugewiesen ist. Dieses Cmdlet löscht untergeordnete Hostgruppen, wenn die Hostgruppe und ihre untergeordneten Hostgruppen keine virtuellen Computerhosts enthalten.

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der auf "True" festgelegten MarkForDeletion-Eigenschaft) zurück oder gibt eine Fehlermeldung zurück, wenn ein Fehler aufgetreten ist.

Beispiele

Beispiel 1: Entfernen der angegebenen Hostgruppe

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

Der erste Befehl ruft die Hostgruppe "HostGroup02" ab und speichert sie in der $HostGroup Variablen.

Der zweite Befehl entfernt das hostgruppenobjekt, das in der $HostGroup Variablen gespeichert ist.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-VMHostGroup

Gibt ein Hostgruppenobjekt für virtuelle Maschinen an.

Type:HostGroup
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Hinweise

  • Erfordert ein VMM-Hostgruppenobjekt, das mithilfe des Cmdlets Get-SCVMHostGroup abgerufen werden kann.