Sdílet prostřednictvím

Remove-SCHardwareProfile

  • Reference
Modul:
VirtualMachineManager

Odebere objekt hardwarového profilu z knihovny VMM.

Syntax

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

Description

Rutina Remove-SCHardwareProfile odebere z knihovny VMM jeden nebo více objektů hardwarového profilu.

Tato rutina vrátí objekt po úspěchu s vlastností MarkedForDeletion nastavenou na $True nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání konkrétního hardwarového profilu z knihovny

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

První příkaz získá objekt profilu hardwaru s názvem NewHWProfile01 z knihovny VMM a uloží objekt do proměnné $HWProfile.

Druhý příkaz odstraní NewHWProfle01 z knihovny a před dokončením operace vyzve uživatele k potvrzení.

Příklad 2: Odebrání všech hardwarových profilů bez výzvy k potvrzení každého odstranění

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

Tento příkaz získá všechny objekty hardwarového profilu v knihovně a předá každý objekt profilu rutině Remove-SCHardwareProfile , která odebere každý hardwarový profil. Pomocí parametru Confirm (Potvrdit ) se nezobrazí výzva k potvrzení, zda chcete odstranit tyto objekty hardwarového profilu.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-HardwareProfile

Určuje objekt hardwarového profilu.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Poznámky

  • Vyžaduje objekt hardwarového profilu VMM, který lze načíst pomocí rutiny Get-SCHardwareProfile .