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ę środowiska 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
PS C:\> 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
PS C:\> 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 w celu pobrania 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 potokowania obiektów do Remove-PSSnapinnazwy obiektów są skojarzone z parametrem Name, który akceptuje obiekty z potoku, które mają właściwość Name.
Przykład 3. Usuwanie przystawek przy użyciu nazw
PS C:\> 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. Symbole wieloznaczne (*) są dozwolone.
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
- 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 wpływa tylko na bieżącą sesję. 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.