Remove-PSSnapin
Usuwa przystawki programu Windows PowerShell z bieżącej sesji.
Składnia
Default (domyślnie)
Remove-PSSnapin
[-Name] <String[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-PSSnapin usuwa przystawkę programu Windows PowerShell z bieżącej sesji. Można go użyć do usuwania przystawek dodanych do programu Windows PowerShell Nie można użyć tego polecenia cmdlet do usunięcia przystawek zainstalowanych za pomocą programu Windows PowerShell.
Po usunięciu przystawki z bieżącej sesji przystawka jest nadal ładowana, ale polecenia cmdlet i dostawcy w przystawce nie są już dostępne w sesji.
Przykłady
Przykład 1. Usuwanie przystawki
Remove-PSSnapin -Name Microsoft.Exchange
To polecenie usuwa przystawkę Microsoft.Exchange z bieżącej sesji. Po zakończeniu polecenia polecenia polecenia i dostawcy obsługiwani przez przystawkę nie są dostępne w sesji.
Przykład 2. Usuwanie przystawek przy użyciu nazw z potokiem
Get-PSSnapin smp* | Remove-PSSnapin
To polecenie usuwa przystawki programu Windows PowerShell, które mają nazwy rozpoczynające się od smp z bieżącej sesji.
Polecenie używa polecenia cmdlet Get-PSSnapin do pobierania obiektów reprezentujących przystawki. Operator potoku (|) wysyła wyniki do polecenia cmdlet Remove-PSSnapin, które usuwa je z sesji. Dostawcy i polecenia cmdlet obsługiwane przez tę przystawkę nie są już dostępne w sesji.
Podczas potoku obiekty do Remove-PSSnapinnazwy obiektów są skojarzone z parametrem Name, który akceptuje obiekty z potoku, które mają właściwość Nazwa.
Przykład 3. Usuwanie przystawek przy użyciu nazw
Remove-PSSnapin -Name *event*
To polecenie usuwa wszystkie przystawki programu Windows PowerShell, które mają nazwy, które zawierają zdarzenie.
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ązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwy przystawek programu Windows PowerShell do usunięcia z bieżącej sesji.
Dozwolone są symbole wieloznaczne (*).
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-PassThru
Zwraca obiekt reprezentujący przystawkę. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
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ązkowe: | 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ązkowe: | 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.
Dane wejściowe
PSSnapInInfo
Do tego polecenia cmdlet można przekazać obiekt przystawki.
Dane wyjściowe
None, System.Management.Automation.PSSnapInInfo
To polecenie cmdlet generuje obiekt System.Management.Automation.PSSnapInInfo, który reprezentuje przystawkę, jeśli określisz parametr PassThru. Domyślnie Remove-PSSnapin nie generuje żadnych danych wyjściowych.
Uwagi
Program Windows PowerShell zawiera następujące aliasy dla Remove-PSSnapin:
rsnp
Remove-PSSnapin nie sprawdza wersji programu Windows PowerShell przed usunięciem przystawki z sesji. Jeśli nie można usunąć przystawki, zostanie wyświetlone ostrzeżenie i polecenie zakończy się niepowodzeniem.
Remove-PSSnapin dotyczy tylko bieżącej sesji. Jeśli dodano polecenie Add-PSSnapin do profilu programu Windows PowerShell, należy usunąć polecenie , aby usunąć przystawkę z przyszłych sesji. Aby uzyskać instrukcje, wpisz Get-Help about_Profiles.
