Freigeben über


Remove-SCVMXComputerConfiguration

Entfernt ein VMX-Computerkonfigurationsobjekt aus VMM.

Syntax

Remove-SCVMXComputerConfiguration
      [-VMXComputerConfiguration] <VmxMachineConfiguration>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das cmdlet Remove-SCVMXComputerConfiguration Cmdlet entfernt mindestens ein VMX-Computerkonfigurationsobjekt aus der VMM-Datenbank (Virtual Machine Manager).

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf "True" festgelegt) zurück oder gibt bei Einem Fehler eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen aller VMX-Computerkonfigurationen, ohne zur Bestätigung der einzelnen Löschungen aufgefordert zu werden

PS C:\> $VMXComputerConfigs = Get-SCVMXComputerConfiguration -VMMServer "VMMServer01.Contoso.com"
PS C:\> $VMXComputerConfigs | Remove-SCVMXComputerConfiguration

Der erste Befehl ruft alle VMX-Computerkonfigurationsobjekte aus der VMM-Datenbank auf VMMServer01 ab und speichert diese Objekte im $VMXComputerConfigs-Objektarray.

Der zweite Befehl übergibt jedes Objekt in $VMXComputerConfigs an Remove-VMXComputerConfiguration, wodurch jedes VMX-Computerkonfigurationsobjekt entfernt wird.

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

-VMXComputerConfiguration

Gibt ein VMX-Computerkonfigurationsobjekt an.

Typ:VmxMachineConfiguration
Aliase:MachineConfig, VMXMachineConfig
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 VMX-Computerkonfigurationsobjekt, das mithilfe des cmdlets Get-SCVMXComputerConfiguration abgerufen werden kann.