Udostępnij za pośrednictwem

Remove-SCHardwareProfile

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt profilu sprzętowego z biblioteki programu VMM.

Składnia

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

Opis

Polecenie cmdlet Remove-SCHardwareProfile usuwa co najmniej jeden obiekt profilu sprzętowego z biblioteki programu VMM.

To polecenie cmdlet zwraca obiekt po pomyślnym powodzeniu z właściwością MarkedForDeletion ustawioną na $True lub zwraca komunikat o błędzie po awarii.

Przykłady

Przykład 1. Usuwanie określonego profilu sprzętu z biblioteki

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

Pierwsze polecenie pobiera obiekt profilu sprzętowego o nazwie NewHWProfile01 z biblioteki programu VMM i przechowuje obiekt w zmiennej $HWProfile.

Drugie polecenie usuwa polecenie NewHWProfle01 z biblioteki, monitując użytkownika o potwierdzenie przed ukończeniem operacji.

Przykład 2. Usuwanie wszystkich profilów sprzętu bez monitowania o potwierdzenie każdego usunięcia

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

To polecenie pobiera wszystkie obiekty profilu sprzętowego w bibliotece i przekazuje każdy obiekt profilu do polecenia cmdlet Remove-SCHardwareProfile , które usuwa każdy profil sprzętu. Nie używając parametru Potwierdź , nie jest wyświetlany monit o potwierdzenie, czy usunąć te obiekty profilu sprzętowego.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-HardwareProfile

Określa obiekt profilu sprzętowego.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Uwagi

  • Wymaga obiektu profilu sprzętowego programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCHardwareProfile .