Informacje o psSnapins

Artykuł
05/09/2024

KRÓTKI OPIS

Opisuje Windows PowerShell przystawki i pokazuje, jak ich używać i zarządzać nimi.

DŁUGI OPIS

Przystawka Windows PowerShell to zestaw .NET Framework firmy Microsoft zawierający dostawców Windows PowerShell i/lub poleceń cmdlet. Windows PowerShell zawiera zestaw podstawowych przystawek, ale możesz rozszerzyć moc i wartość Windows PowerShell przez dodanie przystawki zawierających 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 Windows PowerShell. Możesz również użyć polecenia cmdlet Export-Console, aby zapisać nazwy przystawki w pliku konsoli, a następnie użyć go w przyszłych sesjach. Można nawet zapisać wiele plików konsoli, z których każdy ma inny zestaw przystawek.

UWAGA: Windows PowerShell przystawki (PSSnapins) są dostępne do użycia w Windows PowerShell 3.0 i Windows PowerShell 2.0. Mogą one zostać zmienione lub niedostępne w kolejnych wersjach. Aby spakować Windows PowerShell poleceń cmdlet i dostawców, użyj modułów. Aby uzyskać informacje na temat tworzenia modułów i konwertowania przystawki na moduły, zobacz Pisanie modułu Windows PowerShell.

ZNAJDOWANIE PRZYSTAWEK

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

Get-PSSnapin

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

Get-PSProvider | Format-List name, pssnapin

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

Get-Command -Module <snap-in_name>

INSTALOWANIE PRZYSTAWKI

Wbudowane przystawki są rejestrowane w systemie i dodawane do sesji domyślnej podczas uruchamiania Windows PowerShell. Musisz jednak zarejestrować przystawki utworzone lub pozyskane od innych użytkowników, a następnie dodać przystawki do sesji.

REJESTROWANIE PRZYSTAWKI

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

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

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

Get-PSSnapin -registered

DODAWANIE PRZYSTAWKI DO BIEŻĄCEJ SESJI

Aby dodać zarejestrowaną przystawkę do bieżącej sesji, użyj polecenia cmdlet Add-PSSnapin. Aby na przykład dodać przystawkę 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 PRZYSTAWEK

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

Jeśli dodasz polecenie Add-PSSnapin do profilu, będzie ono dostępne we wszystkich przyszłych sesjach Windows PowerShell. Jeśli wyeksportujesz nazwy przystawki w sesji, możesz użyć pliku eksportu tylko wtedy, gdy są potrzebne przystawki.

Aby dodać polecenie Add-PSSnapin do profilu 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 polecenia cmdlet Export-Console. Aby na przykład zapisać przystawki w bieżącej konfiguracji sesji w pliku NewConsole.psc1 w bieżącym katalogu, wpisz:

Export-Console NewConsole

Aby uzyskać więcej informacji, zobacz Eksportowanie konsoli.

OTWIERANIE PROGRAMU WINDOWS POWERSHELL ZA POMOCĄ PLIKU KONSOLI

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

PowerShell.exe -psconsolefile NewConsole.psc1

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

USUWANIE PRZYSTAWKI

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

Remove-PSSnapin sql

To polecenie cmdlet usuwa przystawkę z sesji. Przystawka jest nadal ładowana, ale dostawcy i polecenia cmdlet, które obsługuje, nie są już dostępne.

WBUDOWANE POLECENIA

W Windows PowerShell 2.0 i w starszych programach hostów w Windows PowerShell 3.0 i nowszych wbudowane polecenia instalowane z Windows PowerShell są pakowane w przystawki, które są dodawane automatycznie do każdej sesji Windows PowerShell.

Począwszy od Windows PowerShell 3.0, w nowszych programach hostów w stylu — tych, które rozpoczynają sesje przy użyciu metody InitialSessionState.CreateDefault2 — wbudowane polecenia są pakowane w modułach. Wyjątek to Microsoft.PowerShell.Core, który zawsze pojawia się jako przystawka. Przystawka Core jest domyślnie uwzględniana w każdej sesji. Wbudowane moduły są ładowane automatycznie do pierwszego użycia.

UWAGA: Sesje zdalne, w tym sesje, które są uruchamiane przy użyciu polecenia cmdlet New-PSSession, są sesjami w starszym stylu, w których wbudowane polecenia są pakowane w przystawki.

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

Microsoft.PowerShell.Core — zawiera dostawców i polecenia cmdlet używane do zarządzania podstawowymi funkcjami Windows PowerShell. Obejmuje on dostawców systemów plików, rejestru, aliasów, środowiska, funkcji i zmiennych oraz podstawowych poleceń cmdlet, takich jak Get-Help, Get-Command i Get-History.
Microsoft.PowerShell.Host — zawiera polecenia cmdlet używane przez hosta Windows PowerShell, takie jak Start-Transcript i Zatrzymaj transkrypcję.
Microsoft.PowerShell.Management — zawiera polecenia cmdlet, takie jak Get-Service i Get-ChildItem używane do zarządzania funkcjami systemu Windows.
Microsoft.PowerShell.Security — zawiera dostawcę certyfikatów i polecenia cmdlet służące do zarządzania zabezpieczeniami Windows PowerShell, takimi jak Get-Acl, Get-AuthenticodeSignature i ConvertTo-SecureString.
Microsoft.PowerShell.Utility — zawiera polecenia cmdlet służące do manipulowania obiektami i danymi, takimi jak Get-Member, Write-Host i Format-List.
Microsoft.WSMan.Management — zawiera dostawcę I polecenia cmdlet WSMan, które zarządzają usługą zarządzania zdalnego systemu Windows, takie jak Connect-WSMan i Enable-WSManCredSSP.

REJESTROWANIE ZDARZEŃ PRZYSTAWKI

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