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 cmdlet add-PSSnapin 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 polecenie Add-PSSnapin 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 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. 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 on polecenia cmdlet Get-PSSnapin z parametrem Registered w celu pobrania obiektów reprezentujących każdą z zarejestrowanych przystawek. Operator potoku (|) przekazuje wynik do add-PSSnapin, co powoduje dodanie ich do sesji. Parametr PassThru zwraca obiekty reprezentujące każdą z dodanych przystawek.

Przykład 3. Rejestrowanie przystawki i dodawanie jej

The first command gets snap-ins that have been added to the current session that include the snap-ins that are installed with Windows PowerShell. In this example, ManagementFeatures is not returned. This indicates that it has not been added to the session.
PS C:\> Get-PSSnapin

The second command gets snap-ins that have been registered on your system, which includes those that have already been added to the session. It does not include the snap-ins that are installed with Windows PowerShell. In this case, the command does not return any snap-ins. This indicates that the ManagementFeatures snapin has not been registered on the system.
PS C:\> Get-PSSnapin -Registered

The third command creates an alias, installutil, for the path of the InstallUtil tool in .NET Framework.
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe

The fourth command uses the InstallUtil tool to register the snap-in. The command specifies the path of ManagementCmdlets.dll, the file name or module name of the snap-in.
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll

The fifth command is the same as the second command. This time, you use it to verify that the ManagementCmdlets snap-in is registered.
PS C:\> Get-PSSnapin -Registered

The sixth command uses the **Add-PSSnapin** cmdlet to add the ManagementFeatures snap-in to the session. It specifies the name of the snap-in, ManagementFeatures, not the file name.
PS C:\> add-pssnapin ManagementFeatures

To verify that the snap-in is added to the session, the seventh command uses the *Module* parameter of the Get-Command cmdlet. It displays the items that were added to the session by a snap-in or module.
PS C:\> Get-Command -Module ManagementFeatures

You can also use the **PSSnapin** property of the object that the **Get-Command** cmdlet returns to find the snap-in or module in which a cmdlet originated. The eighth command uses dot notation to find the value of the PSSnapin property of the Set-Alias cmdlet.
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:False

-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

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

  • Aby uzyskać więcej informacji na temat przystawek, zobacz about_PSSnapins i Jak utworzyć przystawkę programu Windows PowerShell w bibliotece MSDN.

  • 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 w bibliotece MSDN.

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

  • Przed dodaniem przystawki Add-PSSnapin sprawdza wersję przystawki, 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.