Remove-SCHardwareProfile
Usuwa obiekt profilu sprzętu z biblioteki programu VMM.
Składnia
Default (Domyślna)
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 zakończeniu z właściwością MarkedForDeletion ustawioną na wartość $True lub zwraca komunikat o błędzie w przypadku niepowodzenia.
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 NewHWProfle01 z biblioteki, monitując użytkownika o potwierdzenie przed zakończeniem operacji.
Przykład 2: Usuń wszystkie profile sprzętu bez monitu o potwierdzenie każdego usunięcia
PS C:\> Get-SCHardwareProfile | Remove-SCHardwareProfile
To polecenie pobiera wszystkie obiekty profilu sprzętu w bibliotece i przekazuje każdy obiekt profilu do polecenia cmdlet Remove-SCHardwareProfile , które usuwa każdy profil sprzętu. Jeśli parametr Confirm nie zostanie użyty, nie zostanie wyświetlony monit o potwierdzenie, czy usunąć te obiekty profilu sprzętu.
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-HardwareProfile
Określa obiekt profilu sprzętowego.
Właściwości parametru
| Typ: | HardwareProfile |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | Guid |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Uwagi
- Wymaga obiektu profilu sprzętowego programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCHardwareProfile .