Udostępnij za pośrednictwem

Add-PSSnapin

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

Dodaje co najmniej jedną przystawkę programu Windows PowerShell do bieżącej sesji.

Składnia

Add-PSSnapin
   [-Name] <String[]>
   [-PassThru]
   [<CommonParameters>]

Opis

Polecenie Add-PSSnapin cmdlet dodaje zarejestrowane przystawki programu Windows PowerShell do bieżącej sesji. Po dodaniu przystawek można użyć poleceń cmdlet i dostawców, które obsługują przystawki w bieżącej sesji.

Aby dodać przystawkę do wszystkich przyszłych sesji programu Windows PowerShell, dodaj Add-PSSnapin polecenie do profilu programu Windows PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.

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ą polecenia cmdlet Import-Module.

Przykłady

Przykład 1. Dodawanie przystawek

PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD

To polecenie dodaje przystawki Microsoft Exchange i Active Directory do bieżącej sesji.

Przykład 2. Dodawanie wszystkich zarejestrowanych przystawek

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -PassThru

To polecenie dodaje wszystkie zarejestrowane przystawki programu Windows PowerShell do sesji. Używa polecenia cmdlet Get-PSSnapin z zarejestrowanym parametrem, aby uzyskać obiekty reprezentujące każdą z zarejestrowanych przystawek. Operator potoku (|) przekazuje wynik do Add-PSSnapinelementu , który dodaje je do sesji. Parametr PassThru zwraca obiekty reprezentujące każdą z dodanych przystawek.

Przykład 3. Rejestrowanie przystawki i dodawanie jej

Pierwsze polecenie pobiera przystawki, które zostały dodane do bieżącej sesji, które obejmują przystawki zainstalowane za pomocą programu Windows PowerShell. W tym przykładzie funkcja ManagementFeatures nie jest zwracana. Oznacza to, że nie został dodany do sesji.

Drugie polecenie pobiera przystawki, które zostały zarejestrowane w systemie, co obejmuje te, które zostały już dodane do sesji. Nie zawiera przystawek zainstalowanych w programie Windows PowerShell. W takim przypadku polecenie nie zwraca żadnych przystawek. Oznacza to, że przystawka ManagementFeatures nie została zarejestrowana w systemie.

Trzecie polecenie tworzy alias installutil dla ścieżki narzędzia InstallUtil w programie .NET Framework.

Czwarte polecenie używa narzędzia InstallUtil do zarejestrowania przystawki. Polecenie określa ścieżkę ManagementCmdlets.dll, nazwę pliku lub modułu przystawki.

Piąte polecenie jest takie samo jak drugie polecenie. Tym razem użyjesz go do sprawdzenia, czy przystawka ManagementCmdlets jest zarejestrowana.

Szóste polecenie używa Add-PSSnapin polecenia cmdlet , aby dodać przystawkę ManagementFeatures do sesji. Określa nazwę przystawki, ManagementFeatures, a nie nazwę pliku.

Aby sprawdzić, czy przystawka jest dodawana do sesji, siódme polecenie używa parametru Module polecenia cmdlet Get-Command. Wyświetla on elementy dodane do sesji przez przystawkę lub moduł.

Możesz również użyć właściwości PSSnapin obiektu zwracanego Get-Command przez polecenie cmdlet w celu znalezienia przystawki lub modułu, w którym pochodzi polecenie cmdlet. Ósme polecenie używa notacji kropkowej, aby znaleźć wartość właściwości PSSnapin polecenia cmdlet Set-Alias.

PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
PS C:\> (Get-Command Set-Alias).pssnapin

W tym przykładzie pokazano proces rejestrowania przystawki w systemie, a następnie dodawania jej do sesji. Używa ona funkcji ManagementFeatures, fikcyjnej przystawki zaimplementowanej w pliku o nazwie ManagementCmdlets.dll.

Parametry

-Name

Określa nazwę przystawki. Jest to nazwa, a nie nazwa_zestawu ani nazwa_modułu. Dozwolone są symbole wieloznaczne.

Aby znaleźć nazwy zarejestrowanych przystawek w systemie, wpisz Get-PSSnapin -Registered.

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

-PassThru

Wskazuje, że to polecenie cmdlet zwraca obiekt reprezentujący każdy dodany przystawek. 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

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

None or System.Management.Automation.PSSnapInInfo

To polecenie cmdlet zwraca obiekt PSSnapInInfo reprezentujący przystawkę, jeśli określisz parametr PassThru . W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Uwagi

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

  • asnp

Począwszy od programu Windows PowerShell 3.0, podstawowe polecenia zainstalowane za pomocą 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 (PSSnapins). Wyjątkiem jest Microsoft.PowerShell.Core, który jest zawsze przystawką. Ponadto sesje zdalne, takie jak te uruchamiane przez polecenie cmdlet New-PSSession, 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).

Aby uzyskać więcej informacji na temat przystawek, zobacz about_PSSnapins i How to Create a Windows PowerShell Snap-in (Jak utworzyć przystawkę programu Windows PowerShell).

Add-PSSnapin dodaje przystawkę tylko do bieżącej sesji. Aby dodać przystawkę do wszystkich sesji programu Windows PowerShell, dodaj ją do profilu programu Windows PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles.

Możesz dodać dowolną przystawkę, która została zarejestrowana przy użyciu narzędzia instalacyjnego programu Microsoft .NET Framework. Aby uzyskać więcej informacji, zobacz Jak rejestrować polecenia cmdlet, dostawcy i aplikacje hosta.

Aby uzyskać listę przystawek zarejestrowanych na komputerze, wpisz Get-PSSnapin -Registered.

Przed dodaniem przystawki sprawdza wersję przystawki, Add-PSSnapin aby sprawdzić, czy jest ona zgodna z bieżącą wersją programu Windows PowerShell. Jeśli przystawka zakończy się niepowodzeniem sprawdzania wersji, program Windows PowerShell zgłosi błąd.