Delen via

Remove-SCHardwareProfile

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een hardwareprofielobject uit de VMM-bibliotheek.

Syntaxis

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

Description

Met de cmdlet Remove-SCHardwareProfile verwijdert u een of meer hardwareprofielobjecten uit de VMM-bibliotheek.

Deze cmdlet retourneert het object bij succes met de eigenschap MarkedForDeletion ingesteld op $True of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een specifiek hardwareprofiel uit de bibliotheek verwijderen

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

Met de eerste opdracht wordt het hardwareprofielobject met de naam NewHWProfile01 opgehaald uit de VMM-bibliotheek en wordt het object opgeslagen in de $HWProfile variabele.

Met de tweede opdracht wordt NewHWProfle01 uit de bibliotheek verwijderd, waarbij de gebruiker om bevestiging wordt gevraagd voordat de bewerking wordt voltooid.

Voorbeeld 2: Alle hardwareprofielen verwijderen zonder te worden gevraagd om elke verwijdering te bevestigen

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

Met deze opdracht worden alle hardwareprofielobjecten in de bibliotheek opgehaald en elk profielobject doorgegeven aan de Remove-SCHardwareProfile cmdlet, waarmee elk hardwareprofiel wordt verwijderd. Als u de parameter Bevestigen niet gebruikt, wordt u niet gevraagd of u deze hardwareprofielobjecten wilt verwijderen.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-HardwareProfile

Hiermee geeft u een hardwareprofielobject.

Type:HardwareProfile
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Notities

  • Vereist een VMM-hardwareprofielobject dat kan worden opgehaald met behulp van de Get-SCHardwareProfile cmdlet.