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 Get-PSSnapin cmdlet pobiera przystawki programu 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.

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 dodawana tylko przystawka Microsoft.PowerShell.Core . Moduły są importowane automatycznie przy pierwszym użyciu i można je zaimportować za pomocą Import-Module polecenia cmdlet .

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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ą otrzymuje.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla programu Get-PSSnapin:

  • gsnp

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 hostujących, 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 uruchomione przez New-PSSession polecenie cmdlet, są sesjami w starszym stylu, które obejmują podstawowe przystawki.

Aby uzyskać informacje o metodzie CreateDefault2 , która tworzy nowsze sesje z modułami podstawowymi, zobacz CreateDefault2 Method (Metoda CreateDefault2).