New-PSSession
Tworzy trwałe połączenie z komputerem lokalnym lub zdalnym.
Składnia
ComputerName (domyślnie)
New-PSSession
[[-ComputerName] <String[]>]
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-Port <Int32>]
[-UseSSL]
[-ConfigurationName <String>]
[-ApplicationName <String>]
[-ThrottleLimit <Int32>]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Uri
New-PSSession
[-ConnectionUri] <Uri[]>
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]
Session
New-PSSession
[[-Session] <PSSession[]>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ThrottleLimit <Int32>]
[<CommonParameters>]
Opis
Polecenie cmdlet new-PSSession tworzy sesję programu Windows PowerShell (pssession) na komputerze lokalnym lub zdalnym. Podczas tworzenia programu PSSessionprogram Windows PowerShell ustanawia trwałe połączenie z komputerem zdalnym.
Użyj PSSession, aby uruchomić wiele poleceń, które udostępniają dane, takie jak funkcja lub wartość zmiennej. Aby uruchomić polecenia w pssession, użyj polecenia cmdlet Invoke-Command. Aby użyć pssession do bezpośredniej interakcji z komputerem zdalnym, użyj polecenia cmdlet Enter-PSSession. Aby uzyskać więcej informacji, zobacz about_PSSessions (https://go.microsoft.com/fwlink/?LinkID=135181).
Polecenia można uruchamiać na komputerze zdalnym bez tworzenia PSSession przy użyciu parametrów ComputerNameEnter-PSSession lub Invoke-Command. W przypadku używania parametru ComputerName program Windows PowerShell tworzy tymczasowe połączenie, które jest używane dla polecenia, a następnie jest zamykane.
Przykłady
Przykład 1. Tworzenie sesji na komputerze lokalnym
PS C:\> $s = New-PSSession
To polecenie tworzy nowy PSSession na komputerze lokalnym i zapisuje PSSession w zmiennej $s.
Teraz możesz użyć tej pssession do uruchamiania poleceń na komputerze lokalnym.
Przykład 2. Tworzenie sesji na komputerze zdalnym
PS C:\> $Server01 = New-PSSession -ComputerName Server01
To polecenie tworzy nowy PSSession na komputerze Server01 i zapisuje go w zmiennej $Server 01.
Podczas tworzenia wielu obiektów PSSession przypisz je do zmiennych z przydatnymi nazwami. Ułatwi to zarządzanie obiektami PSSession w kolejnych poleceniach.
Przykład 3. Tworzenie sesji na wielu komputerach
PS C:\> $s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03
To polecenie tworzy trzy obiekty PSSession, po jednym na każdym z komputerów określonych przez parametr ComputerName.
Polecenie używa operatora przypisania (=), aby przypisać nowe obiekty PSSession do zmiennych: $s 1, $s 2, $s 3.
Przypisuje pssession server01
Po przypisaniu wielu obiektów do serii zmiennych program Windows PowerShell przypisuje każdy obiekt odpowiednio do zmiennej w serii. Jeśli istnieje więcej obiektów niż zmienne, wszystkie pozostałe obiekty są przypisywane do ostatniej zmiennej. Jeśli istnieje więcej zmiennych niż obiekty, pozostałe zmienne są puste (null).
Przykład 4. Tworzenie sesji przy użyciu określonego portu
PS C:\> New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12
To polecenie tworzy nowy PSSession na komputerze Server01, który łączy się z portem serwera 8081 i używa protokołu SSL. Nowa pssession używa alternatywnej konfiguracji sesji o nazwie E12.
Przed ustawieniem portu należy skonfigurować odbiornik WinRM na komputerze zdalnym do nasłuchiwania na porcie 8081. Aby uzyskać więcej informacji, zobacz opis parametru Port.
Przykład 5. Tworzenie sesji na podstawie istniejącej sesji
PS C:\> New-PSSession -Session $s -Credential Domain01\User01
To polecenie tworzy PSSession z tymi samymi właściwościami co istniejąca PSSession. Można użyć tego formatu polecenia, gdy zasoby istniejącego PSSession są wyczerpane, a do odciążania niektórych wymagań jest potrzebny nowy PSSession.
Polecenie używa parametru sesji
Przykład 6. Tworzenie sesji z zakresem globalnym w innej domenie
PS C:\> $global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01
W tym przykładzie pokazano, jak utworzyć PSSession z zakresem globalnym na komputerze w innej domenie.
Domyślnie obiekty PSSession utworzone w wierszu polecenia są tworzone przy użyciu zakresu lokalnego, a obiekty PSSession utworzone w skrypicie mają zakres skryptu.
Aby utworzyć PSSession z zakresem globalnym, utwórz nową PSSession, a następnie zapisz PSSession w zmiennej rzutowania do zakresu globalnego. W tym przypadku zmienna $s jest rzutowania do zakresu globalnego.
Polecenie używa parametru ComputerName do określenia komputera zdalnego. Ponieważ komputer znajduje się w innej domenie niż konto użytkownika, pełna nazwa komputera jest określana wraz z poświadczeniami użytkownika.
Przykład 7. Tworzenie sesji dla wielu komputerów
PS C:\> $rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50
To polecenie tworzy PSSession na każdym z 200 komputerów wymienionych w pliku Servers.txt i przechowuje wynikowe PSSession w zmiennej $rs. Obiekt PSSession ma limit ograniczenia przepustowości 50.
Można użyć tego formatu polecenia, gdy nazwy komputerów są przechowywane w bazie danych, arkuszu kalkulacyjnym, pliku tekstowego lub innym formacie konwertowanym na tekst.
Przykład 8. Tworzenie sesji przy użyciu identyfikatora URI
PS C:\> $s = New-PSSession -URI http://Server01:91/NewSession -Credential Domain01\User01
To polecenie tworzy PSSession na komputerze Server01 i zapisuje go w zmiennej $s.
Używa on parametru identyfikatora URI
Przykład 9. Uruchamianie zadania w tle w zestawie sesji
PS C:\> $s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
PS C:\> Invoke-Command -Session $s -ScriptBlock {Get-Process PowerShell} -AsJob
Te polecenia tworzą zestaw obiektów
Pierwsze polecenie tworzy nowy PSSession na każdym z komputerów wymienionych w pliku Servers.txt. Używa polecenia cmdlet New-PSSession w celu utworzenia PSSession. Wartość parametru ComputerName to polecenie, które używa polecenia cmdlet Get-Content w celu pobrania listy nazw komputerów Servers.txt pliku.
Polecenie używa parametru Credential
Drugie polecenie używa parametru
Aby uzyskać więcej informacji na temat zadań w tle programu Windows PowerShell, zobacz about_Jobs i about_Remote_Jobs.
Przykład 10: Tworzenie sesji dla komputera przy użyciu jego identyfikatora URI
PS C:\> New-PSSession -ConnectionURI https://management.exchangelabs.com/Management
To polecenie tworzy PSSession obiektów łączących się z komputerem określonym przez identyfikator URI zamiast nazwy komputera.
Przykład 11. Tworzenie opcji sesji
PS C:\> $so = New-PSSessionOption -SkipCACheck
PS C:\> New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01
W tym przykładzie pokazano, jak utworzyć obiekt opcji sesji i użyć parametru SessionOption.
Pierwsze polecenie używa polecenia cmdlet New-PSSessionOption do utworzenia opcji sesji. Zapisuje wynikowy obiekt SessionOption w zmiennej $so.
Drugie polecenie używa opcji w nowej sesji. Polecenie używa polecenia cmdlet New-PSSession w celu utworzenia nowej sesji. Wartość parametru SessionOption to obiekt SessionOption w zmiennej $so.
Parametry
-AllowRedirection
Wskazuje, że to polecenie cmdlet umożliwia przekierowanie tego połączenia do alternatywnego identyfikatora URI (Uniform Resource Identifier).
W przypadku używania parametru ConnectionURI zdalny obiekt docelowy może poinformować o przekierowaniu do innego identyfikatora URI. Domyślnie program Windows PowerShell nie przekierowuje połączeń, ale można użyć tego parametru, aby umożliwić mu przekierowanie połączenia.
Możesz również ograniczyć liczbę przekierowań połączenia, zmieniając wartość opcji sesji MaximumConnectionRedirectionCount. Użyj parametru MaximumRedirection polecenia cmdlet New-PSSessionOption lub ustaw właściwość MaximumConnectionRedirectionCount zmiennej preferencji $PSSessionOption. Wartość domyślna to 5.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Uri
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ApplicationName
Określa segment nazwy aplikacji w URI połączenia. Użyj tego parametru, aby określić nazwę aplikacji, jeśli nie używasz parametru ConnectionURI w poleceniu .
Wartość domyślna to wartość zmiennej preferencji $PSSessionApplicationName na komputerze lokalnym. Jeśli ta zmienna preferencji nie jest zdefiniowana, wartość domyślna to WSMAN. Ta wartość jest odpowiednia dla większości zastosowań. Aby uzyskać więcej informacji, zobacz about_Preference_Variables.
Usługa WinRM używa nazwy aplikacji, aby wybrać odbiornik do obsługi żądania połączenia. Wartość tego parametru powinna odpowiadać wartości właściwości URLPrefix odbiornika na komputerze zdalnym.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Authentication
Określa mechanizm używany do uwierzytelniania poświadczeń użytkownika. Dopuszczalne wartości tego parametru to:
- Wartość domyślna
- Basic
- Credssp
- Podsumowanie
- Kerberos
- Negocjacja
- Nawiąż połączenie przy użyciu poświadczenia domyślnego
Wartość domyślna to Default.
Aby uzyskać więcej informacji na temat wartości tego parametru, zobacz AuthenticationMechanism Enumeration w bibliotece MSDN.
Uwaga: uwierzytelnianie dostawcy obsługi zabezpieczeń poświadczeń (CredSSP), w którym poświadczenia użytkownika są przekazywane do komputera zdalnego do uwierzytelnienia, jest przeznaczone dla poleceń wymagających uwierzytelniania w więcej niż jednym zasobie, takich jak uzyskiwanie dostępu do zdalnego udziału sieciowego. Ten mechanizm zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego poświadczenia przekazywane do niego mogą służyć do kontrolowania sesji sieciowej.
Właściwości parametru
| Typ: | AuthenticationMechanism |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
Uri
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-CertificateThumbprint
Określa cyfrowy certyfikat klucza publicznego (X509) konta użytkownika, które ma uprawnienia do wykonania tej akcji. Wprowadź odcisk palca certyfikatu.
Certyfikaty są używane w uwierzytelnianiu opartym na certyfikatach klienta. Mogą być mapowane tylko na konta użytkowników lokalnych; nie działają z kontami domeny.
Aby uzyskać certyfikat, użyj polecenia Get-Item lub Get-ChildItem w dysku Windows PowerShell Cert: .
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
Uri
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ComputerName
Określa tablicę nazw komputerów. To polecenie cmdlet tworzy trwałe połączenie (PSSession) do określonego komputera. Jeśli wprowadzisz wiele nazw komputerów, New-PSSession tworzy wiele obiektów PSSession, po jednym dla każdego komputera. Wartość domyślna to komputer lokalny.
Wpisz nazwę NetBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny jednego lub kilku komputerów zdalnych. Aby określić komputer lokalny, wpisz nazwę komputera, localhost lub kropkę (.). Jeśli komputer znajduje się w innej domenie niż użytkownik, wymagana jest w pełni kwalifikowana nazwa domeny. Możesz również przekazać nazwę komputera w cudzysłowie, aby new-PSSession.
Aby użyć adresu IP w wartości parametru ComputerName, polecenie musi zawierać parametr Credential. Ponadto należy skonfigurować komputer pod kątem transportu HTTPS lub adres IP komputera zdalnego musi znajdować się na liście Zaufanych Hostów usługi WinRM na komputerze lokalnym. Aby uzyskać instrukcje dotyczące dodawania nazwy komputera do listy TrustedHosts, zobacz "How to Add a Computer to the Trusted Host List" (Jak dodać komputer do listy zaufanych hostów) w about_Remote_Troubleshooting (https://go.microsoft.com/fwlink/?LinkID=135188).
Aby uwzględnić komputer lokalny w wartości parametru ComputerName, uruchom program Windows PowerShell przy użyciu opcji Uruchom jako administrator.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Cn |
Zestawy parametrów
ComputerName
| Position: | 0 |
| Obowiązkowe: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ConfigurationName
Określa konfigurację sesji, która jest używana dla nowej sesji PSSession.
Wprowadź nazwę konfiguracji lub w pełni kwalifikowany identyfikator URI zasobu dla konfiguracji sesji.
Jeśli określisz tylko nazwę konfiguracji, następujący identyfikator URI schematu jest poprzedzany: https://schemas.microsoft.com/PowerShell.
Konfiguracja sesji dla sesji znajduje się na komputerze zdalnym. Jeśli określona konfiguracja sesji nie istnieje na komputerze zdalnym, polecenie zakończy się niepowodzeniem.
Wartość domyślna to wartość zmiennej preferencji $PSSessionConfigurationName na komputerze lokalnym. Jeśli ta zmienna preferencji nie jest ustawiona, wartość domyślna to Microsoft.PowerShell. Aby uzyskać więcej informacji, zobacz about_Preference_Variables.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
Uri
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ConnectionUri
Określa identyfikator URI, który definiuje punkt końcowy połączenia dla sesji. Identyfikator URI musi być w pełni kwalifikowany. Format tego ciągu jest następujący:
<Transport>://<NazwaKomputera>:<Port>/<NazwaAplikacji>
Wartość domyślna jest następująca:
https://localhost:5985/WSMAN
Jeśli nie określiszidentyfikatora ConnectionURI
Prawidłowe wartości segmentu Transport identyfikatora URI to HTTP i HTTPS. Jeśli określisz identyfikator URI połączenia z segmentem Transport, ale nie określisz portu, sesja zostanie utworzona z portami standardów: 80 dla protokołu HTTP i 443 dla protokołu HTTPS. Aby użyć domyślnych portów komunikacji zdalnej programu Windows PowerShell, określ port 5985 dla protokołu HTTP lub 5986 dla protokołu HTTPS.
Jeśli komputer docelowy przekierowuje połączenie do innego identyfikatora URI, program Windows PowerShell uniemożliwia przekierowanie, chyba że użyjesz parametru AllowRedirection w poleceniu .
Właściwości parametru
| Typ: | Uri[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | URI, jednostka pojemności |
Zestawy parametrów
Uri
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to bieżący użytkownik.
Wpisz nazwę użytkownika, taką jak User01, Domain01\User01 lub User@Domain.comlub wprowadź obiekt PSCredential, taki jak jeden zwrócony przez polecenie cmdlet Get-Credential.
Po wpisaniu nazwy użytkownika, ten cmdlet wyświetli monit o podanie hasła.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
Uri
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-EnableNetworkAccess
Wskazuje, że to polecenie cmdlet dodaje interakcyjny token zabezpieczający do sesji sprzężenia zwrotnego. Token interaktywny umożliwia uruchamianie poleceń w sesji sprzężenia zwrotnego, które pobierają dane z innych komputerów. Można na przykład uruchomić polecenie w sesji, która kopiuje pliki XML z komputera zdalnego do komputera lokalnego.
Sesja sprzężenia zwrotnego to pssession, który pochodzi i kończy się na tym samym komputerze. Aby utworzyć sesję sprzężenia zwrotnego, pomiń parametr ComputerName lub ustaw jego wartość na kropkę (.), localhost lub nazwę komputera lokalnego.
Domyślnie to polecenie cmdlet tworzy sesje sprzężenia zwrotnego przy użyciu tokenu sieciowego, co może nie zapewniać wystarczających uprawnień do uwierzytelniania na komputerach zdalnych.
Parametr EnableNetworkAccess jest skuteczny tylko w sesjach sprzężenia zwrotnego. Jeśli używasz EnableNetworkAccess podczas tworzenia sesji na komputerze zdalnym, polecenie zakończy się pomyślnie, ale parametr zostanie zignorowany.
Dostęp zdalny można również włączyć w sesji sprzężenia zwrotnego przy użyciu wartości CredSSP parametru Authentication, który deleguje poświadczenia sesji do innych komputerów.
Aby chronić komputer przed złośliwym dostępem, rozłączone sesje sprzężenia zwrotnego z tokenami interaktywnymi, które są tworzone przy użyciu parametru EnableNetworkAccess, można ponownie nawiązać połączenie tylko z komputera, na którym utworzono sesję. Rozłączone sesje korzystające z uwierzytelniania CredSSP można ponownie połączyć z innymi komputerami. Aby uzyskać więcej informacji, zobacz Disconnect-PSSession.
Ten parametr został wprowadzony w programie Windows PowerShell 3.0.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa przyjazną nazwę PSSession.
Możesz użyć nazwy , aby odwoływać się do PSSession podczas korzystania z innych poleceń cmdlet, takich jak Get-PSSession i Enter-PSSession. Nazwa nie musi być unikatowa dla komputera ani bieżącej sesji.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Port
Określa port sieciowy na komputerze zdalnym używanym na potrzeby tego połączenia. Aby nawiązać połączenie z komputerem zdalnym, komputer zdalny musi nasłuchiwać na porcie używanym przez połączenie. Domyślne porty to 5985, czyli port usługi WinRM dla protokołu HTTP i 5986, czyli port usługi WinRM dla protokołu HTTPS.
Przed użyciem innego portu należy skonfigurować odbiornik WinRM na komputerze zdalnym do nasłuchiwania na tym porcie. Aby skonfigurować odbiornik, użyj następujących poleceń:
1. winrm delete winrm/config/listener?Address=*+Transport=HTTP
2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Nie używaj parametru portów
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Session
Określa tablicę obiektów PSSession, których to polecenie cmdlet używa jako modelu dla nowego PSSession. Ten parametr tworzy nowe obiekty PSSession, które mają te same właściwości co określone obiekty PSSession.
Wprowadź zmienną zawierającą obiekty PSSession lub polecenie, które tworzy lub pobiera obiekty PSSession, takie jak New-PSSession lub Get-PSSession polecenia.
Wynikowe obiektów programu PSSession mają taką samą nazwę komputera, nazwę aplikacji, identyfikator URI połączenia, port, nazwę konfiguracji, limit ograniczenia przepustowości i wartość protokołu SSL (Secure Sockets Layer) jako oryginały, ale mają inną nazwę wyświetlaną, identyfikator i identyfikator wystąpienia (GUID).
Właściwości parametru
| Typ: | PSSession[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
Session
| Position: | 0 |
| Obowiązkowe: | False |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-SessionOption
Określa opcje zaawansowane dla sesji. Wprowadź obiekt SessionOption, taki jak obiekt utworzony przy użyciu polecenia cmdlet New-PSSessionOption lub tabela skrótu, w której klucze są nazwami opcji sesji, a wartości są wartościami opcji sesji.
Wartości domyślne opcji są określane przez wartość zmiennej preferencji $PSSessionOption, jeśli została ustawiona. W przeciwnym razie wartości domyślne są ustanawiane przez opcje ustawione w konfiguracji sesji.
Wartości opcji sesji mają pierwszeństwo przed wartościami domyślnymi sesji ustawionymi w zmiennej preferencji $PSSessionOption i w konfiguracji sesji. Nie mają jednak pierwszeństwa przed maksymalnymi wartościami, limitami przydziału lub limitami ustawionymi w konfiguracji sesji.
Aby uzyskać opis opcji sesji, które zawierają wartości domyślne, zobacz New-PSSessionOption. Aby uzyskać informacje o zmiennej preferencji $PSSessionOption, zobacz about_Preference_Variables. Aby uzyskać więcej informacji na temat konfiguracji sesji, zobacz about_Session_Configurations.
Właściwości parametru
| Typ: | PSSessionOption |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
Uri
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ThrottleLimit
Określa maksymalną liczbę połączeń współbieżnych, które można ustanowić w celu uruchomienia tego polecenia. Jeśli pominięto ten parametr lub wprowadź wartość 0 (zero), zostanie użyta wartość domyślna 32.
Limit ograniczania ma zastosowanie tylko do bieżącego polecenia, a nie do sesji ani do komputera.
Właściwości parametru
| Typ: | Int32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-UseSSL
Wskazuje, że to polecenie cmdlet używa protokołu SSL do nawiązania połączenia z komputerem zdalnym. Domyślnie protokół SSL nie jest używany.
WS-Management szyfruje całą zawartość programu Windows PowerShell przesyłaną przez sieć. Parametr UseSSL oferuje dodatkową ochronę, która wysyła dane za pośrednictwem połączenia HTTPS zamiast połączenia HTTP.
Jeśli używasz tego parametru, ale protokół SSL nie jest dostępny na porcie używanym dla polecenia, polecenie zakończy się niepowodzeniem.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
ComputerName
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
System.String, System.URI, System.Management.Automation.Runspaces.PSSession
Do tego polecenia cmdlet można przekazać ciąg, identyfikator URI lub obiekt sesji.
Dane wyjściowe
PSSession
Uwagi
To polecenie cmdlet używa infrastruktury komunikacji zdalnej programu Windows PowerShell. Aby użyć tego polecenia cmdlet, komputer lokalny i wszystkie komputery zdalne muszą być skonfigurowane do komunikacji zdalnej programu Windows PowerShell. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.
Aby utworzyć pssession na komputerze lokalnym, uruchom program Windows PowerShell z opcją Uruchom jako administrator.
Po zakończeniu pracy z PSSession użyj polecenia cmdlet Remove-PSSession, aby usunąć PSSession i zwolnić jego zasoby.