Udostępnij za pośrednictwem

Remove-PSSnapin

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Usuwa przystawki programu Windows PowerShell z bieżącej sesji.

Składnia

Remove-PSSnapin
      [-Name] <String[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie Remove-PSSnapin cmdlet 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 Get-PSSnapin polecenia cmdlet do pobierania obiektów reprezentujących przystawki. Operator potoku (|) wysyła wyniki do Remove-PSSnapin polecenia cmdlet, które usuwa je z sesji. Dostawcy i polecenia cmdlet obsługiwane przez tę przystawkę nie są już dostępne w sesji.

Podczas potoku do Remove-PSSnapinobiektu nazwy są skojarzone nazwy obiektów 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

Remove-PSSnapin -Name *event*

To polecenie usuwa wszystkie przystawki programu Windows PowerShell, które mają nazwy, które zawierają zdarzenie.

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

-Name

Określa nazwy przystawek programu Windows PowerShell do usunięcia z bieżącej sesji. Dozwolone są symbole wieloznaczne (*).

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

-PassThru

Zwraca obiekt reprezentujący przystawkę. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

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 reprezentujący 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 programu Remove-PSSnapin:

  • rsnp

Remove-PSSnapin program 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 Add-PSSnapin polecenie do profilu programu Windows PowerShell, usuń polecenie , aby usunąć przystawkę z przyszłych sesji. Aby uzyskać instrukcje, wpisz Get-Help about_Profiles.