Udostępnij za pośrednictwem

about_PSSessions

Krótki opis

W tym artykule opisano sesje programu PowerShell (PSSessions) i wyjaśniono, jak nawiązać trwałe połączenie z komputerem zdalnym.

Długi opis

Aby uruchomić polecenia programu PowerShell na komputerze zdalnym, możesz użyć parametru ComputerName polecenia cmdlet lub utworzyć sesję programu PowerShell (PSSession) i uruchomić polecenia w sesji PSSession.

Podczas tworzenia programu PSSession program PowerShell nawiązuje trwałe połączenie z komputerem zdalnym. Użyj programu PSSession, aby uruchomić serię powiązanych poleceń na komputerze zdalnym. Polecenia uruchamiane w tym samym programie PSSession mogą udostępniać dane, takie jak wartości zmiennych, aliasów i funkcji.

Możesz również utworzyć pssession na komputerze lokalnym i uruchomić w nim polecenia. Lokalna usługa PSSession używa infrastruktury komunikacji zdalnej programu PowerShell do tworzenia i obsługi programu PSSession.

Począwszy od programu Windows PowerShell 3.0, sesje PSSessions w systemie Windows są niezależne od sesji, w których są tworzone. Aktywne PSSessions są utrzymywane na komputerze zdalnym (lub komputerze na zdalnym końcu, czyli po stronie serwera połączenia). W związku z tym w systemie Windows można odłączyć się od programu PSSession na zdalnym komputerze z systemem Windows i ponownie nawiązać z nim połączenie później z tego samego komputera lub z innego komputera z systemem Windows.

W tym temacie opisano sposób tworzenia, używania, pobierania i usuwania usług PSSessions. Aby uzyskać bardziej zaawansowane informacje, zobacz about_PSSession_Details.

Uwaga: usługi PSSessions używają infrastruktury komunikacji zdalnej programu PowerShell. Aby można było korzystać z programu PSSessions, należy skonfigurować komputery lokalne i zdalne na potrzeby komunikacji zdalnej. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.

W systemie Windows Vista i nowszych wersjach systemu Windows, aby utworzyć psSession na komputerze lokalnym, należy uruchomić program PowerShell z opcją "Uruchom jako administrator".

Co to jest sesja?

Sesja to środowisko, w którym działa program PowerShell.

Za każdym razem, gdy uruchamiasz program PowerShell, sesja jest tworzona i można uruchamiać polecenia w sesji. Możesz również dodawać elementy do sesji, takie jak moduły i przystawki, oraz tworzyć elementy, takie jak zmienne, funkcje i aliasy. Te elementy istnieją tylko w sesji i są usuwane po zakończeniu sesji.

Można również tworzyć sesje zarządzane przez użytkownika, znane jako "sesje programu PowerShell" lub "PSSessions", na komputerze lokalnym lub na komputerze zdalnym. Podobnie jak w przypadku sesji domyślnej, można uruchamiać polecenia w sesji PSSession i dodawać i tworzyć elementy. Jednak w przeciwieństwie do sesji, która rozpoczyna się automatycznie, można kontrolować utworzone sesje PSSessions. Możesz pobrać, utworzyć, skonfigurować i usunąć je, rozłączyć i ponownie nawiązać z nimi połączenie, a następnie uruchomić wiele poleceń w ramach tej samej usługi PSSession. Sesja PSSession pozostaje dostępna dopóki jej nie usuniesz lub nie wygaśnie.

Zazwyczaj program PSSession służy do uruchamiania serii powiązanych poleceń na komputerze zdalnym. Podczas tworzenia programu PSSession na komputerze zdalnym program PowerShell ustanawia trwałe połączenie z komputerem zdalnym w celu obsługi sesji.

Jeśli używasz parametru ComputerName polecenia cmdlet Invoke-Command lub Enter-PSSession, aby uruchomić zdalne polecenie lub uruchomić sesję interaktywną, program PowerShell tworzy sesję tymczasową na komputerze zdalnym i zamyka sesję natychmiast po zakończeniu lub po zakończeniu sesji interakcyjnej. Nie można kontrolować tych sesji tymczasowych i nie można ich używać do więcej niż jednego polecenia lub jednej sesji interaktywnej.

W programie PowerShell "bieżąca sesja" to sesja, w której pracujesz. "Bieżąca sesja" może odwoływać się do dowolnej sesji, w tym sesji tymczasowej lub sesji PSSession.

Dlaczego warto używać programu PSSession?

Użyj programu PSSession, jeśli potrzebujesz trwałego połączenia z komputerem zdalnym. Za pomocą programu PSSession można uruchomić serię poleceń, które udostępniają dane, takie jak wartość zmiennych, zawartość funkcji lub definicja aliasu.

Polecenia zdalne można uruchamiać bez tworzenia sesji PSSession. Użyj parametru ComputerName w cmdletach obsługujących zdalne wykonywanie, aby uruchomić pojedyncze polecenie lub serię niepowiązanych poleceń na jednym lub wielu komputerach.

W przypadku używania parametru ComputerNameInvoke-Command lub Enter-PSSessionprogram PowerShell ustanawia tymczasowe połączenie z komputerem zdalnym, a następnie zamyka połączenie natychmiast po zakończeniu wykonywania polecenia. Wszystkie utworzone elementy danych zostaną utracone po zamknięciu połączenia.

Inne polecenia cmdlet z parametrem ComputerName, takie jak Get-Eventlog i Get-WmiObject, używają różnych technologii zdalnych do zbierania danych. Żadne połączenie nie jest trwałe tak jak PSSession.

Jak utworzyć usługę PSSession

Aby utworzyć program PSSession, użyj polecenia cmdlet New-PSSession. Aby utworzyć program PSSession na komputerze zdalnym, użyj parametru ComputerName polecenia cmdlet New-PSSession.

Na przykład następujące polecenie tworzy nową konsolę PSSession na komputerze Server01.

New-PSSession -ComputerName Server01

Po przesłaniu polecenia New-PSSession tworzy psSession i zwraca obiekt reprezentujący psSession. Obiekt można zapisać w zmiennej podczas tworzenia programu PSSession lub użyć polecenia Get-PSSession, aby uzyskać psSession w późniejszym czasie.

Na przykład, następujące polecenie tworzy nową sesję PSSession na komputerze Server01 i zapisuje obiekt wynikowy w zmiennej $ps.

$ps = New-PSSession -ComputerName Server01

Jak utworzyć pssessions na wielu komputerach

Aby utworzyć PSSessions na wielu komputerach, użyj parametru ComputerName polecenia cmdlet New-PSSession. Wpisz nazwy komputerów zdalnych na liście rozdzielanej przecinkami.

Aby na przykład utworzyć serwery PSSessions na komputerach Server01, Server02 i Server03, wpisz:

New-PSSession -ComputerName Server01, Server02, Server03

New-PSSession tworzy jedną sesję PSSession na każdym z komputerów zdalnych.

Jak uzyskać usługi PSSessions

Aby uzyskać pliki PSSessions utworzone w bieżącej sesji, użyj polecenia cmdlet Get-PSSession bez parametru ComputerName. Get-PSSession zwraca ten sam typ obiektu, który New-PSSession zwraca.

Następujące polecenie pobiera wszystkie PSSessions, które zostały utworzone w bieżącej sesji.

Get-PSSession

Domyślny widok PSSessions pokazuje ich identyfikator i domyślną nazwę wyświetlaną. Podczas tworzenia sesji można przypisać alternatywną nazwę wyświetlaną.

Id   Name       ComputerName    State    ConfigurationName
---  ----       ------------    -----    ---------------------
1    Session1   Server01        Opened   Microsoft.PowerShell
2    Session2   Server02        Opened   Microsoft.PowerShell
3    Session3   Server03        Opened   Microsoft.PowerShell

Można również zapisać PSSessions w zmiennej. Następujące polecenie pobiera pliki PSSessions i zapisuje je w zmiennej $ps 123.

$ps123 = Get-PSSession

W przypadku korzystania z poleceń cmdlet PSSession można odwołać się do PSSession według jego identyfikatora, nazwy lub identyfikatora wystąpienia (identyfikator GUID). Następujące polecenie pobiera PSSession przy użyciu jego identyfikatora i zapisuje ją w zmiennej $ps01.

$ps01 = Get-PSSession -Id 1

Począwszy od programu Windows PowerShell 3.0, sesje PSSessions są obsługiwane na komputerze zdalnym. Aby uzyskać sesje PSSessions, które utworzyłeś na określonych komputerach zdalnych, użyj parametru ComputerName polecenia cmdlet Get-PSSession. Następujące polecenie pobiera pliki PSSessions utworzone na komputerze zdalnym Server01. Obejmuje to PSSessions utworzone w obecnej sesji oraz w innych sesjach na komputerze lokalnym lub innych komputerach.

Get-PSSession -ComputerName Server01

W programie Windows PowerShell 2.0 Get-PSSession pobiera tylko sesje PSSessions, które zostały utworzone w bieżącej sesji. Nie pobiera sesji PSSessions, które zostały utworzone w innych sesjach lub na innych komputerach, nawet jeśli są one połączone i uruchamiają na komputerze lokalnym polecenia.

Jak uruchamiać polecenia w programie PSSession

Aby uruchomić polecenie w co najmniej jednej PSSession, użyj cmdletu Invoke-Command. Użyj parametru Sesja, aby określić psSessions i parametr ScriptBlock, aby określić polecenie.

Aby na przykład uruchomić polecenie Get-ChildItem ("dir") w każdym z trzech psSessions zapisanych w zmiennej $ps 123, wpisz:

Invoke-Command -Session $ps123 -ScriptBlock { Get-ChildItem }

Jak usunąć usługi PSSessions

Po zakończeniu pracy z programem PSSession użyj polecenia cmdlet Remove-PSSession, aby usunąć program PSSession i zwolnić używane zasoby.

Remove-PSSession -Session $ps

lub

Remove-PSSession -Id 1

Aby usunąć PSSession z komputera zdalnego, użyj parametru ComputerName polecenia cmdlet Remove-PSSession.

Remove-PSSession -ComputerName Server01 -Id 1

Jeśli nie usuniesz programu PSSession, narzędzie PSSession pozostanie dostępne do użycia, dopóki nie upłynął limit czasu.

Możesz również użyć parametru IdleTimeout polecenia cmdlet New-PSSessionOption, aby ustawić czas wygaśnięcia bezczynnej sesji PSSession. Aby uzyskać więcej informacji, zobacz New-PSSessionOption.

Polecenia cmdlet PSSession

Aby uzyskać listę cmdletów PSSession, wpisz:

Get-Help *-PSSession
  • Connect-PSSession: łączy sesję PSSession z bieżącą sesją
  • Disconnect-PSSession: rozłącza sesję PSSession z bieżącej sesji
  • Enter-PSSession: uruchamia sesję interaktywną
  • Exit-PSSession: kończy sesję interaktywną
  • Get-PSSession: pobiera sesje PSSession w bieżącej sesji
  • New-PSSession: Tworzy nową sesję PSSession na komputerze lokalnym lub zdalnym
  • Receive-PSSession: pobiera wyniki poleceń uruchomionych w rozłączonej sesji
  • Remove-PSSession: usuwa PSSessions w bieżącej sesji

Nota

Rozłączone sesje są obsługiwane tylko w systemie operacyjnym Windows. Polecenia cmdlet Connect-PSSession, Disconnect-PSSessioni Receive-PSSession są dostępne tylko w systemie Windows. Aby uzyskać więcej informacji na temat rozłączonych sesji, zapoznaj się z sekcją about_Remote_Disconnected_Session.

Więcej informacji

Aby uzyskać więcej informacji na temat programu PSSessions, zobacz about_PSSession_Details.

Zobacz także

  • Last updated on