Freigeben über

Remove-SCHardwareProfile

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein Hardwareprofilobjekt aus der VMM-Bibliothek.

Syntax

Remove-SCHardwareProfile
      [-HardwareProfile] <HardwareProfile>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCHardwareProfile entfernt mindestens ein Hardwareprofilobjekt aus der VMM-Bibliothek.

Dieses Cmdlet gibt das Objekt nach Erfolg mit der AufschriftForDeletion-Eigenschaft zurück, die auf $True festgelegt ist, oder gibt eine Fehlermeldung beim Fehler zurück.

Beispiele

Beispiel 1: Entfernen eines bestimmten Hardwareprofils aus der Bibliothek

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01"}
PS C:\> Remove-SCHardwareProfile -HardwareProfile $HWProfile -Confirm

Der erste Befehl ruft das Hardwareprofilobjekt namens NewHWProfile01 aus der VMM-Bibliothek ab und speichert das Objekt in der $HWProfile Variablen.

Der zweite Befehl löscht NewHWProfle01 aus der Bibliothek, fordert den Benutzer zur Bestätigung auf, bevor er den Vorgang abgeschlossen hat.

Beispiel 2: Entfernen aller Hardwareprofile, ohne aufgefordert zu werden, jede Löschung zu bestätigen

PS C:\> Get-SCHardwareProfile | Remove-SCHardwareProfile

Dieser Befehl ruft alle Hardwareprofilobjekte in der Bibliothek ab und übergibt jedes Profilobjekt an das Cmdlet Remove-SCHardwareProfile , das jedes Hardwareprofil entfernt. Wenn Sie den Parameter "Bestätigen " nicht verwenden, werden Sie nicht aufgefordert, zu bestätigen, ob diese Hardwareprofilobjekte gelöscht werden sollen.

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

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Type:HardwareProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-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-Hardwareprofilobjekt, das mithilfe des Cmdlets Get-SCHardwareProfile abgerufen werden kann.