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 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

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. Symbole wieloznaczne (*) są dozwolone.

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, 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

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.