Freigeben über

Remove-SCVMHostGroup

  • Referenz
Modul:
VirtualMachineManager

Entfernt eine Hostgruppe aus VMM.

Syntax

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

Beschreibung

Mit dem Cmdlet Remove-SCVMHostGroup-Cmdlet werden mindestens ein Hostgruppenobjekt aus der VMM-Datenbank (Virtual Machine Manager) entfernt. Eine Hostgruppe kann nicht gelöscht werden, wenn sie einer privaten Cloud zugeordnet ist, wenn sie Hosts zugewiesen hat oder deren untergeordnete 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 zurück (wobei die MarkedForDeletion-Eigenschaft auf "True" festgelegt ist) oder bei Einem Fehler eine Fehlermeldung zurück.

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 variablen $HostGroup.

Mit dem zweiten Befehl wird das hostgruppenobjekt entfernt, das in der variablen $HostGroup gespeichert ist.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

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

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMHostGroup

Gibt ein Hostgruppenobjekt eines virtuellen Computers an.

Typ:HostGroup
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Hinweise

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