Informacje o PSSnapins

KRÓTKI OPIS

W tym artykule opisano przystawki programu Windows PowerShell i pokazano, jak ich używać i zarządzać nimi.

DŁUGI OPIS

Przystawka programu Windows PowerShell to zestaw programu Microsoft .NET Framework, który zawiera dostawców i/lub polecenia cmdlet programu Windows PowerShell. Program Windows PowerShell zawiera zestaw podstawowych przystawek, ale można rozszerzyć możliwości i wartość programu Windows PowerShell, dodając przystawki zawierające dostawców i poleceń cmdlet, które tworzysz lub pobierasz od innych.

Po dodaniu przystawki polecenia cmdlet i dostawców, które zawiera, są natychmiast dostępne do użycia w bieżącej sesji, ale zmiana ma wpływ tylko na bieżącą sesję.

Aby dodać przystawkę do wszystkich przyszłych sesji, zapisz ją w profilu programu Windows PowerShell. Za pomocą polecenia cmdlet Export-Console można również zapisać nazwy przystawek w pliku konsoli, a następnie użyć go w przyszłych sesjach. Możesz nawet zapisać wiele plików konsoli, z których każdy ma inny zestaw przystawek.

UWAGA: Przystawki programu Windows PowerShell (PSSnapins) są dostępne do użycia w programach Windows PowerShell 3.0 i Windows PowerShell 2.0. Mogą one zostać zmienione lub niedostępne w kolejnych wersjach. Aby spakować polecenia cmdlet i dostawców programu Windows PowerShell, należy użyć modułów. Aby uzyskać informacje o tworzeniu modułów i konwertowaniu przystawek na moduły, zobacz Pisanie modułu programu Windows PowerShell.

ZNAJDOWANIE SNAP-INS

Aby uzyskać listę przystawek programu Windows PowerShell na komputerze, wpisz:

Get-PSSnapin

Aby pobrać przystawkę dla każdego dostawcy programu Windows PowerShell, wpisz:

Get-PSProvider | Format-List name, pssnapin

Aby uzyskać listę poleceń cmdlet w przystawce programu Windows PowerShell, wpisz:

Get-Command -Module <snap-in_name>

INSTALOWANIE SNAP-IN

Wbudowane przystawki są rejestrowane w systemie i dodawane do sesji domyślnej podczas uruchamiania programu Windows PowerShell. Należy jednak zarejestrować przystawki tworzone lub uzyskiwane od innych osób, a następnie dodawać przystawki do sesji.

REJESTRACJA SNAP-IN

Przystawka programu Windows PowerShell to program napisany w języku .NET Framework, który jest kompilowany do pliku .dll. Aby korzystać z dostawców i poleceń cmdlet w przystawce, należy najpierw zarejestrować przystawkę (dodać ją do rejestru).

Większość przystawek zawiera program instalacyjny (plik .exe lub .msi), który rejestruje plik .dll. Jeśli jednak otrzymasz przystawkę jako plik .dll, możesz ją zarejestrować w swoim systemie. Aby uzyskać więcej informacji, zobacz Jak rejestrować polecenia cmdlet, dostawcy i aplikacje hosta w bibliotece MSDN.

Aby pobrać wszystkie zarejestrowane przystawki w systemie lub sprawdzić, czy przystawka jest zarejestrowana, wpisz:

Get-PSSnapin -registered

DODAWANIE SNAP-IN DO BIEŻĄCEJ SESJI

Aby dodać zarejestrowaną przystawkę do bieżącej sesji, użyj polecenia cmdlet Add-PSSnapin. Aby na przykład dodać przystawkę programu Microsoft SQL Server do sesji, wpisz:

Add-PSSnapin sql

Po zakończeniu polecenia dostawcy i polecenia cmdlet w przystawce są dostępne w sesji. Są one jednak dostępne tylko w bieżącej sesji, chyba że je zapiszesz.

ZAPISYWANIE SNAP-INS

Aby używać przystawki w przyszłych sesjach programu Windows PowerShell, dodaj polecenie Add-PSSnapin do profilu programu Windows PowerShell. Możesz też wyeksportować nazwy przystawki do pliku konsoli.

Jeśli dodasz polecenie Add-PSSnapin do swojego profilu, będzie ono dostępne we wszystkich przyszłych sesjach środowiska Windows PowerShell. W przypadku eksportowania nazw przystawek w sesji można użyć pliku eksportu tylko wtedy, gdy są potrzebne przystawki.

Aby dodać polecenie Add-PSSnapin do profilu programu Windows PowerShell, otwórz profil, wklej lub wpisz polecenie, a następnie zapisz profil. Aby uzyskać więcej informacji, zobacz about_Profiles.

Aby zapisać przystawki z sesji w pliku konsoli (psc1), użyj Export-Console polecenia cmdlet. Na przykład, aby zapisać przystawki w bieżącej konfiguracji sesji w pliku NewConsole.psc1 w bieżącym katalogu, należy wpisać:

Export-Console NewConsole

Aby uzyskać więcej informacji, zobacz Export-Console.

OTWIERANIE PROGRAMU WINDOWS POWERSHELL ZA POMOCĄ PLIKU KONSOLI

Aby użyć pliku konsoli zawierającego przystawkę, uruchom program Windows PowerShell (PowerShell.exe) z wiersza polecenia w Cmd.exe lub w innej sesji programu Windows PowerShell. Użyj parametru PsConsoleFile, aby określić plik konsoli, który zawiera przystawkę. Na przykład następujące polecenie uruchamia program Windows PowerShell z plikiem konsoli NewConsole.psc1:

PowerShell.exe -psconsolefile NewConsole.psc1

Dostawcy i polecenia cmdlet w przystawce są teraz dostępne do użycia w sesji.

USUWANIE SNAP-IN

Aby usunąć przystawkę programu Windows PowerShell z bieżącej sesji, użyj polecenia cmdlet Remove-PSSnapin. Aby na przykład usunąć przystawkę programu SQL Server z bieżącej sesji, wpisz:

Remove-PSSnapin sql

To polecenie cmdlet usuwa przystawkę z sesji. Przystawka jest nadal ładowana, ale dostawcy i obsługiwane przez nią polecenia cmdlet nie są już dostępne.

BUILT-IN POLECENIA

W programie Windows PowerShell 2.0 i w programach hosta starszego typu w programie Windows PowerShell 3.0 i nowszych wbudowane polecenia instalowane z programem Windows PowerShell są pakowane w przystawki, które są dodawane automatycznie do każdej sesji programu Windows PowerShell.

Począwszy od Windows PowerShell 3.0, w nowszych programach hosta — tych, które uruchamiają sesje przy użyciu metody InitialSessionState.CreateDefault2 — wbudowane polecenia są spakowane w moduły. Wyjątkiem jest Microsoft.PowerShell.Core, który zawsze pojawia się jako przystawka. Przystawka Core jest domyślnie dołączana do każdej sesji. Wbudowane moduły są ładowane automatycznie przy pierwszym użyciu.

UWAGA: Sesje zdalne, w tym sesje uruchamiane za pomocą polecenia cmdlet New-PSSession, to sesje starszego typu, w których wbudowane polecenia są spakowane w przystawki.

Następujące przystawki (lub moduły) są instalowane z programem Windows PowerShell.

Microsoft.PowerShell.Core — zawiera dostawców i polecenia cmdlet używane do zarządzania podstawowymi funkcjami programu Windows PowerShell. Obejmuje ona dostawców systemu plików, rejestru, aliasu, środowiska, funkcji i zmiennych oraz podstawowe polecenia cmdlet, takie jak Get-Help, Get-Command i Get-History.
Microsoft.PowerShell.Host — zawiera polecenia cmdlet używane przez hosta programu Windows PowerShell, takie jak Start-Transcript i Stop-Transcript.
Microsoft.PowerShell.Management — zawiera polecenia cmdlet, takie jak Get-Service i Get-ChildItem, które są używane do zarządzania funkcjami opartymi na systemie Windows.
Microsoft.PowerShell.Security — zawiera dostawcę certyfikatów i polecenia cmdlet używane do zarządzania zabezpieczeniami programu Windows PowerShell, takie jak Get-Acl, Get-AuthenticodeSignature i ConvertTo-SecureString.
Microsoft.PowerShell.Utility — zawiera polecenia cmdlet używane do manipulowania obiektami i danymi, takimi jak Get-Member, Write-Host i Format-List.
Microsoft.WSMan.Management — zawiera dostawcę WSMan i polecenia cmdlet, które zarządzają usługą zdalnego zarządzania systemem Windows, takie jak Connect-WSMan i Enable-WSManCredSSP.

REJESTROWANIE ZDARZEŃ SNAP-IN

Począwszy od Windows PowerShell 3.0, można rejestrować zdarzenia wykonywania poleceń cmdlet w modułach i przystawkach programu Windows PowerShell, ustawiając właściwość LogPipelineExecutionDetails modułów i przystawek na wartość TRUE. Aby uzyskać więcej informacji, zobacz about_EventLogs.