about_PSSnapins

  • Artykuł

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 może zawierać dostawców i 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. Możesz również użyć Export-Console polecenia cmdlet , aby zapisać nazwy przystawki w pliku konsoli, a następnie użyć tej zapisanej konfiguracji w przyszłych sesjach.

Począwszy od programu Windows PowerShell 3.0, polecenia cmdlet dostarczane za pomocą programu PowerShell są pakowane w modułach. Wyjątkiem jest Microsoft.PowerShell.Core, który jest jedyną pozostałą przystawką. Przystawka Microsoft.PowerShell.Core jest domyślnie ładowana w każdej sesji. Pozostałe moduły są ładowane automatycznie podczas pierwszego użycia. Aby uzyskać więcej informacji, zobacz about_Modules.

Znajdowanie przystawki

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 pobrać wszystkie zarejestrowane przystawki w systemie lub sprawdzić, czy przystawka jest zarejestrowana, wpisz:

Get-PSSnapin -registered

Aby uzyskać listę poleceń cmdlet w przystawce programu 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 programu Windows PowerShell. Należy jednak zarejestrować przystawki tworzone lub uzyskiwane od innych osób, a następnie dodawać przystawki do sesji.

Dodawanie przystawki do bieżącej sesji

Aby dodać zarejestrowaną przystawkę do bieżącej sesji, użyj Add-PsSnapin polecenia cmdlet . 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 zostaną zapisane.

Zapisywanie przystawek

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

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

Aby dodać Add-PsSnapin polecenie do profilu programu Windows PowerShell, otwórz swój 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 . Aby na przykład zapisać przystawki w bieżącej konfiguracji NewConsole.psc1 sesji w pliku w bieżącym katalogu, wpisz:

Export-Console NewConsole

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

Otwieranie programu Windows PowerShell przy użyciu pliku konsoli

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

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ę programu Windows PowerShell z bieżącej sesji, użyj Remove-PsSnapin polecenia cmdlet . 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.

Zdarzenia przystawek dzienników

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

Zobacz też