Udostępnij za pomocą

New-PSSession

Moduł:
Microsoft.PowerShell.Core Module

Tworzy trwałe połączenie z komputerem lokalnym lub zdalnym.

Składnia

ComputerName (Domyślna) 

New-PSSession
    [[-ComputerName] <String[]>]
    [-Credential <PSCredential>]
    [-Name <String[]>]
    [-EnableNetworkAccess]
    [-ConfigurationName <String>]
    [-Port <Int32>]
    [-UseSSL]
    [-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>]

VMId 

New-PSSession
    [-VMId] <Guid[]>
    -Credential <PSCredential>
    [-Name <String[]>]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

VMName 

New-PSSession
    -Credential <PSCredential>
    -VMName <String[]>
    [-Name <String[]>]
    [-ConfigurationName <String>]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

Session 

New-PSSession
    [[-Session] <PSSession[]>]
    [-Name <String[]>]
    [-EnableNetworkAccess]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

ContainerId 

New-PSSession
    -ContainerId <String[]>
    [-Name <String[]>]
    [-ConfigurationName <String>]
    [-RunAsAdministrator]
    [-ThrottleLimit <Int32>]
    [<CommonParameters>]

UseWindowsPowerShellParameterSet 

New-PSSession
    [-Name <String[]>]
    [-UseWindowsPowerShell]
    [<CommonParameters>]

SSHHost 

New-PSSession
    [-HostName] <String[]>
    [-Name <String[]>]
    [-Port <Int32>]
    [-UserName <String>]
    [-KeyFilePath <String>]
    [-Subsystem <String>]
    [-ConnectingTimeout <Int32>]
    [-SSHTransport]
    [-Options <Hashtable>]
    [<CommonParameters>]

SSHHostHashParam 

New-PSSession
    -SSHConnection <Hashtable[]>
    [-Name <String[]>]
    [<CommonParameters>]

Opis

Polecenie New-PSSession cmdlet tworzy sesję programu PowerShell (PSSession) na komputerze lokalnym lub zdalnym. Podczas tworzenia programu PSSession program PowerShell nawiązuje 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 programie PSSession, użyj Invoke-Command polecenia cmdlet . Aby użyć programu PSSession do bezpośredniej interakcji z komputerem zdalnym, użyj Enter-PSSession polecenia cmdlet . Aby uzyskać więcej informacji, zobacz about_PSSessions.

Polecenia można uruchamiać na komputerze zdalnym bez tworzenia psSession z parametrami ComputerName parametrów Enter-PSSession lub Invoke-Command. Gdy używasz parametru ComputerName , program PowerShell tworzy tymczasowe połączenie, które jest używane dla polecenia, a następnie jest zamykane.

Począwszy od programu PowerShell 6.0, można użyć protokołu Secure Shell (SSH), aby nawiązać połączenie i utworzyć sesję na komputerze zdalnym, jeśli protokół SSH jest dostępny na komputerze lokalnym, a komputer zdalny jest skonfigurowany z punktem końcowym SSH programu PowerShell. Zaletą sesji zdalnej programu PowerShell opartej na protokole SSH jest to, że może działać na wielu platformach (Windows, Linux, macOS). W przypadku sesji opartych na protokole SSH należy użyć parametru HostName lub SSHConnection ustawionego w celu określenia komputera zdalnego i odpowiednich informacji o połączeniu. Aby uzyskać więcej informacji na temat konfigurowania komunikacji zdalnej protokołu SSH programu PowerShell, zobacz Komunikacja zdalna programu PowerShell za pośrednictwem protokołu SSH.

Uwaga / Notatka

W przypadku korzystania z komunikacji wirtualnej programu WSMan z klienta systemu Linux lub macOS z punktem końcowym HTTPS, w którym certyfikat serwera nie jest zaufany (np. certyfikat z podpisem własnym). Należy podać element PSSessionOption , który zawiera wartości SkipCACheck i SkipCNCheck , aby pomyślnie nawiązać $true połączenie. Należy to zrobić tylko wtedy, gdy jesteś w środowisku, w którym można być pewnym certyfikatem serwera i połączeniem sieciowym z systemem docelowym.

Przykłady

Przykład 1. Tworzenie sesji na komputerze lokalnym

$s = New-PSSession

To polecenie tworzy nową konsolę PSSession na komputerze lokalnym i zapisuje plik 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

$Server01 = New-PSSession -ComputerName Server01

To polecenie tworzy nową konsolę PSSession na komputerze Server01 i zapisuje je w zmiennej $Server01 .

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

$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 (=) do przypisania nowych obiektów PSSession do zmiennych: $s1, , $s2$s3. Przypisuje serwer Server01 PSSession do $s1, server02 PSSession do $s2, i Server03 PSSession do $s3.

Po przypisaniu wielu obiektów do serii zmiennych program 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

New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12

To polecenie tworzy nową pssession na komputerze Server01, który łączy się z portem 8081 serwera i używa protokołu SSL. Nowa usługa 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

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 Sesja parametru New-PSSession , aby określić psSession zapisane w zmiennej $s . Używa poświadczeń Domain1\Admin01 użytkownika do wykonania polecenia.

Przykład 6. Tworzenie sesji z zakresem globalnym w innej domenie

$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 rzutowy 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

$rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50

To polecenie tworzy psSession na każdym z 200 komputerów wymienionych w Servers.txt pliku i przechowuje wynikową pssession w zmiennej $rs . Obiekty PSSession mają limit 50ograniczenia przepustowości .

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

$s = New-PSSession -Uri http://Server01:91/NewSession -Credential Domain01\User01

To polecenie tworzy pssession na komputerze Server01 i przechowuje go w zmiennej $s . Używa on parametru identyfikatora URI , aby określić protokół transportu, komputer zdalny, port i konfigurację sesji alternatywnej. Używa również parametru Credential, aby określić konto użytkownika, które ma uprawnienia do tworzenia sesji na komputerze zdalnym.

Przykład 9. Uruchamianie zadania w tle w zestawie sesji

$s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
Invoke-Command -Session $s -ScriptBlock {Get-Process powershell} -AsJob

Te polecenia tworzą zestaw obiektów PSSession, a następnie uruchamiają zadanie w tle w każdym z obiektów PSSession.

Pierwsze polecenie tworzy nowe pssession na każdym z komputerów wymienionych w Servers.txt pliku. Używa New-PSSession polecenia cmdlet do utworzenia programu PSSession. Wartość parametru ComputerName jest poleceniem, które używa Get-Content polecenia cmdlet do pobrania listy komputerów nazw Servers.txt plików.

Polecenie używa parametru Credential do utworzenia obiektów PSSession , które mają uprawnienia administratora domeny, i używa parametru ThrottleLimit , aby ograniczyć polecenie do 16 współbieżnych połączeń. Polecenie zapisuje obiekty PSSession w zmiennej $s .

Drugie polecenie używa parametru Invoke-CommandAsJob polecenia cmdlet, aby uruchomić zadanie w tle, które uruchamia Get-Process powershell polecenie w każdym obiekcie PSSession w systemie $s.

Aby uzyskać więcej informacji na temat zadań w tle programu PowerShell, zobacz about_Jobs i about_Remote_Jobs.

Przykład 10: Tworzenie sesji dla komputera przy użyciu jego identyfikatora URI

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

$so = New-PSSessionOption -SkipCACheck
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 New-PSSessionOption polecenia cmdlet do utworzenia opcji sesji. Zapisuje wynikowy obiekt SessionOption w zmiennej $so .

Drugie polecenie używa opcji w nowej sesji. Polecenie używa New-PSSession polecenia cmdlet do utworzenia nowej sesji. Wartość parametru SessionOption to obiekt SessionOption w zmiennej $so .

Przykład 12: Tworzenie sesji przy użyciu protokołu SSH

New-PSSession -HostName UserA@LinuxServer01

W tym przykładzie pokazano, jak utworzyć nową sesję PSSession przy użyciu protokołu Secure Shell (SSH). Jeśli na komputerze zdalnym skonfigurowano protokół SSH w celu wyświetlenia monitu o podanie haseł, zostanie wyświetlony monit o podanie hasła. W przeciwnym razie konieczne będzie użycie uwierzytelniania użytkownika opartego na kluczu SSH.

Przykład 13: Tworzenie sesji przy użyciu protokołu SSH i określanie portu i klucza uwierzytelniania użytkownika

New-PSSession -HostName UserA@LinuxServer01:22 -KeyFilePath C:\<path>\userAKey_rsa

W tym przykładzie pokazano, jak utworzyć sesję PSSession przy użyciu protokołu Secure Shell (SSH). Używa parametru Port do określenia portu do użycia i parametru KeyFilePath w celu określenia klucza RSA używanego do identyfikowania i uwierzytelniania użytkownika na komputerze zdalnym.

Przykład 14. Tworzenie wielu sesji przy użyciu protokołu SSH

$sshConnections = @(
    @{
          HostName    = 'WinServer1'
          UserName    = 'domain\userA'
          KeyFilePath = 'C:\Users\UserA\id_rsa'
    }
    @{
        HostName    = 'UserB@LinuxServer5'
        KeyFilePath = 'C:\UserB\<path>\id_rsa'
    }
)
New-PSSession -SSHConnection $sshConnections

W tym przykładzie pokazano, jak utworzyć wiele sesji przy użyciu protokołu Secure Shell (SSH) i zestawu parametrów SSHConnection . Parametr SSHConnection przyjmuje tablicę tabel skrótów, które zawierają informacje o połączeniu dla każdej sesji. Należy pamiętać, że ten przykład wymaga, aby docelowe komputery zdalne miały skonfigurowany protokół SSH do obsługi uwierzytelniania użytkowników opartego na kluczach.

Przykład 15: Tworzenie nowej sesji przy użyciu opcji SSH

$options = @{
    Port=22
    User = 'UserB'
    Host = 'LinuxServer5'
}
New-PSSession -KeyFilePath '/Users/UserB/id_rsa' -Options $options

W tym przykładzie pokazano, jak utworzyć nową sesję opartą na protokole SSH zdalną maszynę z systemem Linux przy użyciu opcji SSH. Parametr Opcje przyjmuje tabelę skrótów wartości, które są przekazywane jako opcje do bazowego ssh polecenia ustanowione połączenie z systemem zdalnym.

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 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 New-PSSessionOptionMaximumRedirection polecenia cmdlet lub ustaw właściwość MaximumConnectionRedirectionCount zmiennej preferencji $PSSessionOption. Wartość domyślna to 5.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Uri
Position:Named
Obowiązkowy: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ązkowy: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:

  • Default
  • Basic
  • Credssp
  • Digest
  • Kerberos
  • Negotiate
  • NegotiateWithImplicitCredential

Wartość domyślna to Default.

Aby uzyskać więcej informacji na temat wartości tego parametru, zobacz Wyliczenia Mechanizmów Uwierzytelniania.

Ostrzeżenie

Uwierzytelnianie przez dostawcę obsługi zabezpieczeń poświadczeń (CredSSP), w którym poświadczenia użytkownika są przekazywane do zdalnego komputera w celu ich uwierzytelnienia, jest przeznaczone dla poleceń wymagających uwierzytelniania w więcej niż jednym zasobie, takich jak dostęp 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ązkowy: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ązkowy: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 Get-Item polecenia lub Get-ChildItem na dysku programu 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ązkowy: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ązkowy: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 utworzysz 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, localhostlub 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 do 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.

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ązkowy: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: http://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ązkowy: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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
VMId
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
VMName
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
ContainerId
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ConnectingTimeout

Określa czas w milisekundach dozwolony do ukończenia początkowego połączenia SSH. Jeśli połączenie nie zostanie ukończone w określonym czasie, zostanie zwrócony błąd.

Ten parametr został wprowadzony w programie PowerShell 7.2

Właściwości parametru

Typ:Int32
Domyślna wartość:unlimited
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHost
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
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>://<ComputerName>:<Port>/<ApplicationName>

Wartość domyślna jest następująca:

http://localhost:5985/WSMAN

Jeśli nie określiszidentyfikatora ConnectionURI , możesz użyć parametr ówUseSSL , ComputerName, Porti parametrów ApplicationName, aby określić wartości identyfikatora 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 HTTPS. Aby użyć domyślnych portów komunikacji zdalnej programu 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, PowerShell blokuje 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ązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-ContainerId

Określa tablicę identyfikatorów kontenerów. To polecenie cmdlet rozpoczyna interakcyjną sesję z każdym z określonych kontenerów. Użyj polecenia docker ps, aby uzyskać listę identyfikatorów kontenerów. Aby uzyskać więcej informacji, zobacz pomoc dotyczącą polecenia docker ps.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ContainerId
Position:Named
Obowiązkowy: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 lub Domain01\User01, lub wprowadź obiekt PSCredential wygenerowany przez polecenie cmdlet Get-Credential. Jeśli wpiszesz nazwę użytkownika, zostanie wyświetlony monit o wprowadzenie hasła.

Poświadczenia są przechowywane w obiekcie PSCredential, a hasło jest przechowywane jako SecureString.

Uwaga / Notatka

Aby uzyskać więcej informacji na temat ochrony danych SecureString, zobacz Jak bezpieczny jest protokół SecureString?.

Właściwości parametru

Typ:PSCredential
Domyślna wartość:Current user
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ComputerName
Position:Named
Obowiązkowy: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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
VMId
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False
VMName
Position:Named
Obowiązkowy:True
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ę (.), localhostlub 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.

Można również włączyć dostęp zdalny w sesji sprzężenia zwrotnego przy użyciu CredSSP wartości parametru uwierzytelniania , 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 PowerShell 3.0.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ComputerName
Position:Named
Obowiązkowy: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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
Session
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HostName

Określa tablicę nazw komputerów dla połączenia opartego na protokole Secure Shell (SSH). Jest to podobne do parametru ComputerName , z tą różnicą, że połączenie z komputerem zdalnym jest wykonywane przy użyciu protokołu SSH, a nie windows WinRM.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHost
Position:0
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-KeyFilePath

Określa ścieżkę pliku klucza używaną przez protokół Secure Shell (SSH) do uwierzytelniania użytkownika na komputerze zdalnym.

Protokół SSH umożliwia uwierzytelnianie użytkowników za pośrednictwem kluczy prywatnych/publicznych jako alternatywy dla podstawowego uwierzytelniania haseł. Jeśli komputer zdalny jest skonfigurowany do uwierzytelniania klucza, ten parametr może służyć do podania klucza identyfikującego użytkownika.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:IdentityFilePath

Zestawy parametrów

SSHHost
Position:Named
Obowiązkowy: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łać 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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Options

Określa tabelę skrótu opcji SSH używanych podczas nawiązywania połączenia z zdalną sesją opartą na protokole SSH. Możliwe opcje to wszystkie wartości obsługiwane przez wersję polecenia SSH opartą na systemie Unix.

Wszystkie wartości jawnie przekazywane przez parametry mają pierwszeństwo przed wartościami przekazanymi w tabeli skrótów Opcje . Na przykład użycie parametru Port zastępuje dowolną Port parę klucz-wartość przekazaną w tabeli skrótowej Opcje.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHost
Position:Named
Obowiązkowy: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, który jest portem 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 , chyba że musisz. Ustawienie portu w poleceniu ma zastosowanie do wszystkich komputerów lub sesji, na których jest uruchamiane polecenie. Ustawienie alternatywnego portu może uniemożliwić uruchomienie polecenia na wszystkich komputerach.

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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
SSHHost
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RunAsAdministrator

Wskazuje, że narzędzie PSSession działa jako administrator.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ContainerId
Position:Named
Obowiązkowy: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 polecenie lub Get-PSSession .

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ązkowy: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 jest 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ązkowy: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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SSHConnection

Ten parametr przyjmuje tablicę tabel skrótów, gdzie każda tabela skrótów zawiera co najmniej jeden parametr połączenia wymagany do ustanowienia połączenia secure Shell (SSH) (HostName, Port, UserName, KeyFilePath).

Parametry połączenia w formie skrótu są takie same jak zdefiniowane dla zestawu parametrów SSHHost .

Parametr SSHConnection jest przydatny do tworzenia wielu sesji, w których każda sesja wymaga różnych informacji o połączeniu.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:

Hashtable[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHostHashParam
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SSHTransport

Wskazuje, że połączenie zdalne zostało nawiązane przy użyciu protokołu Secure Shell (SSH).

Domyślnie program PowerShell używa usługi Windows WinRM do nawiązywania połączenia z komputerem zdalnym. Ten przełącznik zmusza program PowerShell do używania zestawu parametrów HostName do ustanawiania połączenia zdalnego opartego na protokole SSH.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Dopuszczalne wartości:true
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHost
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Subsystem

Określa podsystem SSH używany na potrzeby nowej usługi PSSession.

Określa podsystem do użycia w obiekcie docelowym zgodnie z definicją w pliku sshd_config. Podsystem uruchamia określoną wersję programu PowerShell ze wstępnie zdefiniowanymi parametrami. Jeśli określony podsystem nie istnieje na komputerze zdalnym, polecenie zakończy się niepowodzeniem.

Jeśli ten parametr nie jest używany, wartością domyślną powershell jest podsystem.

Właściwości parametru

Typ:String
Domyślna wartość:powershell
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHost
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
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 pominiesz ten parametr lub wprowadzisz 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

ComputerName
Position:Named
Obowiązkowy: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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
VMId
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
VMName
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
Session
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False
ContainerId
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UserName

Określa nazwę użytkownika konta użytego do utworzenia sesji na komputerze zdalnym. Metoda uwierzytelniania użytkownika zależy od konfiguracji protokołu Secure Shell (SSH) na komputerze zdalnym.

Jeśli protokół SSH jest skonfigurowany do uwierzytelniania podstawowego hasła, zostanie wyświetlony monit o podanie hasła użytkownika.

Jeśli protokół SSH jest skonfigurowany do uwierzytelniania użytkownika opartego na kluczach, ścieżkę pliku klucza można podać za pomocą parametru KeyFilePath i nie zostanie wyświetlony monit o podanie hasła. Należy pamiętać, że jeśli plik klucza użytkownika klienta znajduje się w znanej lokalizacji SSH, parametr KeyFilePath nie jest wymagany do uwierzytelniania opartego na kluczach, a uwierzytelnianie użytkownika odbywa się automatycznie na podstawie nazwy użytkownika. Aby uzyskać więcej informacji, zobacz dokumentację protokołu SSH dotyczącą uwierzytelniania użytkowników opartego na kluczach.

Nie jest to wymagany parametr. Jeśli nie określono parametru UserName , bieżąca nazwa użytkownika logowania jest używana dla połączenia.

Ten parametr został wprowadzony w programie PowerShell 6.0.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SSHHost
Position:Named
Obowiązkowy: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 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ść:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

ComputerName
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UseWindowsPowerShell

Tworzy połączenie zdalne z nową przestrzenią uruchamiania programu Windows PowerShell w systemie lokalnym.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

UseWindowsPowerShellParameterSet
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-VMId

Określa tablicę identyfikatorów maszyn wirtualnych. To polecenie cmdlet uruchamia interaktywną sesję programu PowerShell Direct z każdą z określonych maszyn wirtualnych. Aby uzyskać więcej informacji, zobacz Virtual Machine automation and management using PowerShell (Automatyzacja maszyn wirtualnych i zarządzanie nimi przy użyciu programu PowerShell).

Użyj Get-VM polecenia , aby wyświetlić maszyny wirtualne dostępne na hoście Hyper-V.

Właściwości parametru

Typ:

Guid[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:VmGuid

Zestawy parametrów

VMId
Position:0
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-VMName

Określa tablicę nazw maszyn wirtualnych. To polecenie cmdlet uruchamia interaktywną sesję programu PowerShell Direct z każdą z określonych maszyn wirtualnych. Aby uzyskać więcej informacji, zobacz Virtual Machine automation and management using PowerShell (Automatyzacja maszyn wirtualnych i zarządzanie nimi przy użyciu programu PowerShell).

Użyj Get-VM polecenia , aby wyświetlić maszyny wirtualne dostępne na hoście Hyper-V.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

VMName
Position:Named
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
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

String

Możesz przesłać ciąg do tego polecenia cmdlet.

System.URI

Możesz przekazać identyfikator URI do tego polecenia cmdlet.

PSSession

Do tego polecenia cmdlet można przekazać obiekt sesji.

Dane wyjściowe

PSSession

Uwagi

Program PowerShell zawiera następujące aliasy dla New-PSSession:

  • Wszystkie platformy:

    • nsn

  • To polecenie cmdlet używa infrastruktury komunikacji zdalnej programu PowerShell. Aby użyć tego polecenia cmdlet, komputer lokalny i wszystkie komputery zdalne muszą być skonfigurowane do komunikacji zdalnej programu PowerShell. Aby uzyskać więcej informacji, zobacz about_Remote_Requirements.

  • Aby utworzyć program PSSession na komputerze lokalnym, uruchom program PowerShell z opcją Uruchom jako administrator .

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

  • Zestawy parametrów HostName i SSHConnection zostały dołączone począwszy od programu PowerShell 6.0. Dodano je w celu zapewnienia komunikacji zdalnej programu PowerShell na podstawie protokołu Secure Shell (SSH). Komunikacja zdalna protokołu SSH i programu PowerShell jest obsługiwana na wielu platformach (Windows, Linux, macOS) i komunikacji zdalnej programu PowerShell na tych platformach, na których zainstalowano i skonfigurowano program PowerShell. Jest to oddzielone od poprzedniej komunikacji równorzędnej tylko z systemem Windows opartej na usłudze WinRM, a wiele funkcji i ograniczeń dotyczących usługi WinRM nie ma zastosowania. Na przykład przydziały oparte na usłudze WinRM, opcje sesji, niestandardowa konfiguracja punktu końcowego i funkcje rozłączania/ponownego łączenia nie są obsługiwane. Aby uzyskać więcej informacji na temat konfigurowania komunikacji zdalnej protokołu SSH programu PowerShell, zobacz Komunikacja zdalna programu PowerShell za pośrednictwem protokołu SSH.

Plik ssh wykonywalny uzyskuje dane konfiguracji z następujących źródeł w następującej kolejności:

  1. Opcje wiersza polecenia
  2. plik konfiguracji użytkownika (~/.ssh/config)
  3. plik konfiguracji dla całego systemu (/etc/ssh/ssh_config)

Następujące parametry polecenia cmdlet są mapowane na ssh parametry i opcje:

Parametr polecenia cmdlet Parametr ssh równoważna opcja ssh -o
-KeyFilePath -i <KeyFilePath> -o IdentityFile=<KeyFilePath>
-UserName -l <UserName> -o User=<UserName>
-Port -p <Port> -o Port=<Port>
-ComputerName -Subsystem -s <ComputerName> <Subsystem> -o Host=<ComputerName>

Wszystkie wartości jawnie przekazywane przez parametry mają pierwszeństwo przed wartościami przekazanymi w tabeli skrótów Opcje . Aby uzyskać więcej informacji na temat ssh_config plików, zobacz ssh_config(5).