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ętu o nazwie NewHWProfile01 z biblioteki programu VMM i przechowuje obiekt w zmiennej $HWProfile.

Drugie polecenie usuwa polecenie NewHWProfle01 z biblioteki, wyświetlając użytkownikowi monit 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, co powoduje usunięcie każdego profilu sprzętu. Nie używając parametru Confirm, nie jest wyświetlany monit o potwierdzenie usunięcia tych obiektów profilu sprzętowego.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HardwareProfile

Określa obiekt profilu sprzętowego.

Typ:HardwareProfile
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Uwagi

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