about_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 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.
