Udostępnij za pośrednictwem

Get-PSSnapin

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

Pobiera przystawki programu Windows PowerShell na komputerze.

Składnia

Get-PSSnapin
   [[-Name] <String[]>]
   [-Registered]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-PSSnapin pobiera przystawki środowiska Windows PowerShell, które zostały dodane do bieżącej sesji lub które zostały zarejestrowane w systemie. To polecenie cmdlet wyświetla listę przystawek w kolejności, w której są wykrywane.

get-PSSnapin pobiera tylko zarejestrowane przystawki. Aby zarejestrować przystawkę programu Windows PowerShell, użyj narzędzia InstallUtil dołączonego do programu Microsoft .NET Framework 2.0. Aby uzyskać więcej informacji, zobacz Jak rejestrować polecenia cmdlet, dostawcy i aplikacje hosta w bibliotece MSDN.

Począwszy od programu Windows PowerShell 3.0, podstawowe polecenia zawarte w programie Windows PowerShell są pakowane w modułach. Wyjątkiem jest Microsoft.PowerShell.Core, który jest przystawką (PSSnapin). Domyślnie do sesji jest dodawany tylko przystawka Microsoft.PowerShell.Core. Moduły są importowane automatycznie przy pierwszym użyciu i można je zaimportować za pomocą polecenia cmdlet Import-Module.

Przykłady

Przykład 1. Pobieranie aktualnie załadowanych przystawek

PS C:\> Get-PSSnapIn

To polecenie pobiera przystawki programu Windows PowerShell, które są obecnie ładowane w sesji. Obejmuje to przystawki zainstalowane za pomocą programu Windows PowerShell oraz te, które zostały dodane do sesji.

Przykład 2. Pobieranie zarejestrowanych przystawek

PS C:\> get-PSSnapIn -Registered

To polecenie pobiera przystawki programu Windows PowerShell, które zostały zarejestrowane na komputerze, w tym te, które zostały już dodane do sesji. Dane wyjściowe nie obejmują przystawek zainstalowanych w programie Windows PowerShell lub przystawce programu Windows PowerShell bibliotek dynamicznych linków (DLL), które nie zostały jeszcze zarejestrowane w systemie.

Przykład 3. Pobieranie bieżących przystawek pasujących do ciągu

PS C:\> Get-PSSnapIn -Name smp*

To polecenie pobiera przystawki programu Windows PowerShell w bieżącej sesji, które mają nazwy rozpoczynające się od smp.

Parametry

-Name

Określa tablicę nazw przystawek. To polecenie cmdlet pobiera tylko określone przystawki programu Windows PowerShell. Dozwolone są symbole wieloznaczne.

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

-Registered

Wskazuje, że to polecenie cmdlet pobiera przystawki programu Windows PowerShell, które zostały zarejestrowane w systemie, nawet jeśli nie zostały jeszcze dodane do sesji.

Przystawki zainstalowane za pomocą programu Windows PowerShell nie są wyświetlane na tej liście.

Bez tego parametru get-PSSnapin pobiera przystawki programu Windows PowerShell, które zostały dodane do sesji.

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

Dane wejściowe

None

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

Dane wyjściowe

PSSnapInInfo

Get-PSSnapin zwraca obiekt dla każdej przystawki, którą pobiera.

Uwagi

  • Począwszy od programu Windows PowerShell 3.0, podstawowe polecenia instalowane przy użyciu programu Windows PowerShell są pakowane w modułach. W programie Windows PowerShell 2.0 i programach hosta, które tworzą starsze sesje w nowszych wersjach programu Windows PowerShell, podstawowe polecenia są pakowane w przystawkach (PSSnapin). Wyjątkiem jest Microsoft.PowerShell.Core, który jest zawsze przystawką. Ponadto sesje zdalne, takie jak te uruchamiane przez polecenie cmdlet New-PSSession, to sesje w stylu starszym, które obejmują podstawowe przystawki.

    Aby uzyskać informacje na temat metody CreateDefault2, która tworzy nowsze sesje z podstawowymi modułami, zobacz CreateDefault2 Method w bibliotece MSDN.