modul: Microsoft.PowerShell.Core

creează o conexiune persistentă la un computer local sau la distanță.

Sintaxa

New-PSSession <PSSession>] >] 
New-PSSession >] 
New-PSSession >] -SSHConnection <Hashtable> 

Descriere

New-PSSession cmdlet creează o sesiune de PowerShell (PSSession) la nivel local sau remotecomputer. Când creați un PSSession, PowerShell stabilește o conexiune persistentă lacalculatorul de la distanță.,

utilizați un PSSession pentru a rula mai multe comenzi care partajează date, cum ar fi o funcție sau valoarea avariable. Pentru a rula comenzi într-o PSSession, utilizați Invoke-Command cmdlet. Pentru a utilizapssesiune pentru a interacționa direct cu un computer la distanță, utilizați cmdlet-ul Enter-PSSession. Formore informații, vezi about_PSSessions.

puteți rula comenzi pe un computer la distanță, fără a crea o PSSession prin utilizarea theComputerName parametrii Enter-PSSession sau Invoke-Command., Când utilizați parametrul theComputerName, PowerShell creează o conexiune temporară care este utilizată pentru comandăși este apoi închisă.

Incepand cu PowerShell 6.0 puteți utiliza Secure Shell (SSH) pentru a stabili o conexiune și să creăm o sesiune pe un computer la distanță, dacă SSH este disponibil pe computerul local și de la distanță computerul isconfigured cu un PowerShell SSH final. Beneficiul unei sesiuni PowerShell remote bazate pe SSH estecă poate funcționa pe mai multe platforme (Windows, Linux, macOS)., Pentru sesiunile bazate pe SSH utilizați numele de gazdă sau parametrul SSHConnection setat pentru a specifica computerul la distanță și informațiile relevantconnection. Pentru mai multe informații despre cum să configurați PowerShell SSH remoting, seePowerShell Remoting peste SSH.

notă

atunci când se utilizează remoting WSMan de la un client Linux sau macOS cu un punct final HTTPS în cazul în care serverul nu este de încredere (de exemplu, un certificat auto-semnat). Tu trebuie să furnizeze un PSSessionOptioncare include -SkipCACheck și -SkipCNCheck cu succes a stabili conexiunea., Faceți acest lucru numai dacă vă aflați într-un mediu în care puteți fi sigur de certificatul serverului și de conexiunea rețelei la sistemul țintă.

Exemple

Exemplu 1: Creați o sesiune pe computerul local

$s = New-PSSession

Această comandă creează un nou PSSession pe computerul local și salvează PSSession în$s variabilă.acum Puteți utiliza această PSSession pentru a rula comenzi pe computerul local.,

Exemplul 2: Crearea unei sesiuni pe un computer la distanță

$Server01 = New-PSSession -ComputerName Server01

Această comandă creează un nou PSSession pe Server01 calculator și salvează-l în $Server01variabilă.când creați mai multe obiecte PSSession, atribuiți-le variabilelor cu nume utile. Acest lucru vă va ajuta să gestionați obiectele PSSession în comenzile ulterioare.

Exemplul 3: Crearea de sesiuni de pe mai multe calculatoare

$s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03

Această comandă creează trei PSSession obiecte, câte una pe fiecare dintre calculatoarele specificate de theComputerName parametru.,

comanda foloseste operatorul de atribuire (=) pentru a atribui noul PSSession obiecte la variabile:$s1, $s2, $s3. Se atribuie Server01 PSSession să $s1, la Server02 PSSession să$s2, și Server03 PSSession să $s3.când atribuiți mai multe obiecte la o serie de variabile, PowerShell atribuie fiecare obiect la avariable în seria respectiv., Dacă există mai multe obiecte decât variabile, toate obiectele rămasesunt atribuite ultimei variabile. Dacă există mai multe variabile decât obiecte, variabilele rămasesunt goale (null).

Exemplul 4: Creați o sesiune cu un port specificat

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

Această comandă creează un nou PSSession pe Server01 computer care se conectează la portul serverului 8081and folosește protocolul SSL. Noua PSSession utilizează o configurație alternativă de sesiune numită12.

înainte de a seta portul, trebuie să configurați ascultătorul WinRM pe computerul de la distanță pentru a asculta onport 8081., Pentru mai multe informații, consultați descrierea parametrului Port.

exemplul 5: Creați o sesiune bazată pe o sesiune existentă

New-PSSession -Session $s -Credential Domain01\User01

această comandă creează o PSSession cu aceleași proprietăți ca o PSSession existentă. Puteți utiliza acest format de comandă atunci când resursele unui PSSession existent sunt epuizate și este necesară o newPSSession pentru a descărca o parte din cerere.

comanda folosește Sesiune de parametrul New-PSSession pentru a specifica PSSession salvat în $s variabilă., Utilizează acreditările utilizatorului Domain1 \ Admin01 pentru a finaliza comanda.

exemplul 6: Creați o sesiune cu un domeniu global într-un domeniu diferit

$global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01

Acest exemplu arată cum se creează o PSSession cu un domeniu global pe un computer într-un alt domeniu.

în mod implicit, obiectele PSSession create la linia de comandă sunt create cu scop local șiobiectele PSSession create într-un script au scope script.

pentru a crea o PSSession cu global scope, creați o nouă PSSession și apoi stocați thePSSession într-o variabilă care este distribuită într-un global scope., În acest caz, variabila $s este distribuită într-un domeniu global.

comanda utilizează parametrul ComputerName pentru a specifica computerul la distanță. Deoarece computeruleste într-un domeniu diferit de contul de utilizator, numele complet al computerului este specificat împreunăcu acreditările utilizatorului.

exemplul 7: creați sesiuni pentru multe computere

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

această comandă creează o PSSession pe fiecare dintre cele 200 de computere listate în servere.fișierul txt andit stochează PSSession rezultat în variabila $rs., Obiectele PSSession au athrottle limită de 50.

puteți utiliza acest format de comandă atunci când numele computerelor sunt stocate într-o bază de date, foaie de calcul,fișier text sau alt format convertibil de text.

Exemplul 8: Creați o sesiune folosind un URI

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

Această comandă creează un PSSession pe Server01 calculator și îl stochează în $s variabilă. Utilizează parametrul URI pentru a specifica protocolul de transport, computerul la distanță, portul și configurația sesiunii analternate., De asemenea, utilizează parametrul de acreditare pentru a specifica un cont de utilizatorcare are permisiunea de a crea o sesiune pe computerul de la distanță.

Exemplul 9: Rula un fundal de muncă într-un set de sesiuni

Aceste comenzi crea un set de PSSession obiecte și apoi executați un loc de muncă de fond în fiecare din thePSSession obiecte.

prima comandă creează o nouă PSSession pe fiecare dintre computerele listate în servere.txtfile. Acesta utilizează New-PSSession cmdlet pentru a crea PSSession., Valoarea theComputerName parametru este o comandă care utilizează Get-Content cmdlet-ului pentru a obține lista ofcomputer nume de Servere.fișier txt.

comanda folosește parametrul Credential pentru a crea obiectele PSSession care au permisiunea unui administrator de domeniu și folosește parametrul ThrottleLimit pentru a limita comanda la 16 conexiuni concurente. Comanda Salvează obiectele PSSession în variabila $s.,

Cea de-a doua comandă folosește AsJob parametru al Invoke-Command cmdlet-ului pentru a începe o backgroundjob care ruleaza un Get-Process PowerShell comandă în fiecare dintre PSSession obiecte în $s.

Pentru mai multe informații despre joburile de fundal PowerShell, vezi about_jobs și about_Remote_Jobs.

Exemplul 10: Creați o sesiune pentru un computer, folosindu-URI

New-PSSession -ConnectionURI https://management.exchangelabs.com/Management

Această comandă creează un PSSession obiecte care se conectează la un computer care este specificat de către un URIinstead de un nume de computer.,

exemplul 11: creați o opțiune de sesiune

Acest exemplu arată cum să creați un obiect de opțiune de sesiune și să utilizați parametrul SessionOption.

prima comandă utilizează New-PSSessionOption cmdlet pentru a crea o opțiune de sesiune. Se salvează Theresulting SessionOption obiect în$so variabilă.

a doua comandă utilizează opțiunea într-o nouă sesiune. Comanda utilizează New-PSSession cmdlet pentrucreați o nouă sesiune. Valoarea parametrului SessionOption este obiectul SessionOption in$so variabilă.,

exemplul 12: creați o sesiune folosind SSH

New-PSSession -HostName UserA@LinuxServer01

Acest exemplu arată cum să creați o nouă PSSession folosind Secure Shell (SSH). Dacă SSH este configuratpe computerul de la distanță pentru a solicita parole, atunci veți primi o solicitare de parolă. În caz contrar, va trebui să utilizați autentificarea utilizatorului bazată pe cheia SSH.

exemplul 13: creați o sesiune folosind SSH și specificați portul și cheia de autentificare a utilizatorului

New-PSSession -HostName UserA@LinuxServer01:22 -KeyFilePath c:\\userAKey_rsa

Acest exemplu arată cum se creează o PSSession folosind Secure Shell (SSH)., Folosește Portparameter pentru a specifica portul de utilizat și KeyFilePath parametru pentru a specifica o cheie RSA folosit identifice și autentificarea utilizatorului pe computerul la distanță.

Exemplu 14: Creați mai multe sesiuni folosind SSH

Acest exemplu arată cum să creați mai multe sesiuni folosind Secure Shell (SSH) și theSSHConnection set de parametri. Parametrul SSHConnection are o serie de tabele hash careconține informații de conectare pentru fiecare sesiune. Rețineți că acest exemplu necesită ca computerele targetremote să aibă SSH configurat pentru a sprijini autentificarea utilizatorului bazată pe cheie.,

Parametrii

-AllowRedirection

Indică faptul că acest cmdlet permite redirecționarea conexiunea asta la o altă Uniformă ResourceIdentifier (URI).

când utilizați parametrul ConnectionURI, destinația la distanță poate returna o instrucțiune toredirect la un URI diferit. În mod implicit, PowerShell nu redirecționează conexiunile, ci tupot utiliza acest parametru pentru a permite redirecționarea conexiunii.

de asemenea, puteți limita numărul de redirecționări ale conexiunii modificând valoarea opțiunii sesiunii maximconnectionredirectioncount., Use the MaximumRedirection parameterof the New-PSSessionOption cmdlet or set the MaximumConnectionRedirectionCount property of the$PSSessionOption preference variable. The default value is 5.,

Tip: SwitchParameter
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False

-Dezinstalare

– Specifică numele aplicației segment de conexiune URI. Utilizați acest parametru pentru a specificanumele aplicației atunci când nu utilizați parametrul ConnectionURI din comandă.,

valoarea implicită este valoarea variabilei de preferință $PSSessionApplicationName pe computerul local. Dacă această variabilă de preferință nu este definită, valoarea implicită este WSMAN. Această valoare estepotrivit pentru majoritatea utilizărilor. Pentru mai multe informații, a se vedea about_preference_variables.serviciul WinRM utilizează numele aplicației pentru a selecta un ascultător pentru a deservi solicitarea de conexiune.Valoarea acestui parametru ar trebui să se potrivească cu valoarea proprietății URLPrefix a unui ascultător pecomputerul de la distanță.,

Type: String
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-Authentication

Specifies the mechanism that is used to authenticate the user’s credentials.,Valorile acceptabile pentru acest parametru sunt:

  • Default
  • Basic
  • Credssp
  • Digest
  • Kerberos
  • Negotiatewithimplicitcredential

valoarea implicită este implicită.

Pentru mai multe informații despre valorile acestui parametru, a se vedeaautenticationmechanism enumerare.,

Atenție:

Acreditare Security Support Provider (CredSSP) de autentificare, în care acreditările de utilizator arepassed la un computer la distanță să fie autentificate, este conceput pentru comenzi care requireauthentication pe mai mult de o resursă, cum ar fi accesarea de la distanță o partajare de rețea. Acest mecanismcrește riscul de securitate al funcționării la distanță. Dacă computerul de la distanță este compromis, potențialele care sunt transmise acestuia pot fi utilizate pentru a controla sesiunea de rețea.,div>

Type: AuthenticationMechanism Accepted values: Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False
-CertificateThumbprint

Specifies the digital public key certificate (X509) of a user account that has permission to performthis action., Introduceți amprenta certificatului certificatului.

certificatele sunt utilizate în autentificarea bazată pe certificate client. Acestea pot fi mapate numai la conturile de utilizator local; nu funcționează cu conturi de domeniu.pentru a obține un certificat, utilizați comanda Get-Itemsau Get-ChildItem din unitatea PowerShell Cert:.,

Type: String
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ComputerName

Specifies an array of names of computers. This cmdlet creates a persistent connection(PSSession) to the specified computer., Dacă introduceți mai multe nume de computer, New-PSSessioncreează mai multe obiecte PSSession, câte unul pentru fiecare computer. Implicit este computerul local.

tastați numele NetBIOS, o adresă IP sau un nume de domeniu complet calificat al unuia sau mai multor computere de la distanță. Pentru a specifica computerul local, tastați numele computerului, localhost sau un punct (.). Când thecomputer se află într-un domeniu diferit de utilizator, este necesar numele de domeniu complet calificat. Youcan, de asemenea, țeavă un nume de calculator, în ghilimele, la New-PSSession.,

pentru a utiliza o adresă IP în valoarea parametrului ComputerName, comanda trebuie să includă parametrul credențial. De asemenea, computerul trebuie să fie configurat pentru transportul HTTPS sau adresa IP a computerului la distanță trebuie inclusă în lista WinRM TrustedHosts de pe computerul local. Pentru instrucțiuni pentru adăugarea unui nume de computer în lista TrustedHosts, consultați „Cum să adăugați un computer în lista de gazde de încredere” inabout_Remote_Troubleshooting.pentru a include computerul local în valoarea parametrului ComputerName, porniți WindowsPowerShell utilizând opțiunea Run as administrator.,

Type: String
Aliases: Cn
Position: 0
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-ConfigurationName

Specifies the session configuration that is used for the new PSSession.

Enter a configuration name or the fully qualified resource URI for a session configuration., Dacă specificați numai numele configurației, următoarea schemă URI este prefixată:

The session configuration for a session is located on the remote computer. If the specified sessionconfiguration does not exist on the remote computer, the command fails.

The default value is the value of the $PSSessionConfigurationName variabila de preferință pe computerul local. Dacă această variabilă de preferință nu este setată, implicit este Microsoft.PowerShell. Pentru mai multe informații, consultați about_Preference_Variables.,

Type: String
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-ConnectionUri

Specifies a URI that defines the connection endpoint for the session. The URI must be fullyqualified., Formatul acestui șir este după cum urmează:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

valoarea implicită este după cum urmează:

If you do not specify a ConnectionURI, you can use the UseSSL, ComputerName, Port, andApplicationName parameters to specify the ConnectionURI values.

Valid values for the Transport segment of the URI are HTTP and HTTPS. If you specify a connectionURI with a Transport segment, but do not specify a port, the session is created with standardsports: 80 for HTTP and 443 for HTTPS. To use the default ports for PowerShell remoting, specify port5985 for HTTP or 5986 for HTTPS.

If the destination computer redirects the connection to a different URI, PowerShell prevents theredirection unless you use the AllowRedirection parameter in the command.

Type: Uri
Aliases: URI, CU
Position: 0
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-ContainerId

Specifies an array of IDs of containers. This cmdlet starts an interactive session with each of thespecified containers. Use the docker ps comandă pentru a obține o listă de container Id-uri. Pentru mai multe informații, consultați ajutorul pentrucomanda Docker ps.,

Tip: String
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: True
Acceptă metacaractere: False
-Acreditare

Specifică un cont de utilizator care are permisiunea de a face această acțiune. Implicit este utilizatorul curent.

Tastați un nume de utilizator, cum ar fi User01 sau Domain01\User01, sau introduceți un PSCredential objectgenerated de Get-Credential cmdlet., Dacă tastați un nume de utilizator, vi se solicită să introducețiparola.acreditările sunt stocate într-un PSCredentialobject și parola este stocată ca SecureString.pentru mai multe informații despre SecureString protecția datelor, seeHow secure este SecureString?.,

Tip: PSCredential
Poziție: Nume
valoare Implicită: utilizatorul Curent
Accepta conducta de intrare: True
Acceptă metacaractere: False

-EnableNetworkAccess

Indică faptul că acest cmdlet adaugă un interactive security token pentru loopback sesiuni. Interactivetoken vă permite să rulați comenzi în sesiunea loopback care obține date de la alte computere., De exemplu, puteți rula o comandă în sesiune care copiază fișierele XML de la un computer la distanță la localcomputer.

o sesiune loopback este o sesiune PSSession care provine și se termină pe același computer. Pentru a crea sesiunea aloopback, omiteți parametrul ComputerName sau setați valoarea acestuia la dot (.), localhost sau thename al computerului local.

în mod implicit, acest cmdlet creează sesiuni de loopback utilizând un jeton de rețea, care ar putea să nu ofere permisiunea suficientă de a se autentifica pe computere la distanță.parametrul EnableNetworkAccess este eficient numai în sesiunile de loopback., Dacă utilizațienablenetworkaccess când creați o sesiune pe un computer la distanță, comanda reușește, dar parametrul este ignorat.

De asemenea, puteți activa accesul la distanță într-o sesiune loopback utilizând valoarea CredSSP a parametrului de autentificare, care deleagă acreditările sesiunii către alte computere.

Pentru a proteja computerul de malware acces, deconectat loopback sesiuni care au interactivetokens, care sunt cele create prin utilizarea EnableNetworkAccess parametru, poate fi reconnectedonly de la calculatorul pe care sesiunea a fost creat., Sesiuni deconectate care utilizează Crediteleaautentificarea poate fi reconectată de la alte computere. Pentru mai multe informații, consultațiDisconnect-PSSession.acest parametru a fost introdus în PowerShell 3.0.,

Tip: SwitchParameter
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False
-HostName

Specifică o serie de nume de calculator pentru o Secure Shell (SSH) bazate pe conexiune. Acest lucru este similar cu parametrul ComputerName, cu excepția faptului că conexiunea la computerul de la distanță se face folosind Ssshrather decât Windows WinRM.,

This parameter was introduced in PowerShell 6.0.

Type: String
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyFilePath

Specifies a key file path used by Secure Shell (SSH) to authenticate a user on a remote computer.,SSH permite autentificarea utilizatorului prin chei private / publice ca alternativă la autentificarea basicpassword. Dacă computerul la distanță este configurat pentru autentificarea cheilor, atunci acest lucruparametrul poate fi utilizat pentru a furniza cheia care identifică utilizatorul.acest parametru a fost introdus în PowerShell 6.0.,

Type: String
Aliases: IdentityFilePath
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Specifies a friendly name for the PSSession.

You can use the name to refer to the PSSession when you use other cmdlets, such asGet-PSSession and Enter-PSSession., Numele nu este necesar să fie unic pentru computer sausesiunea curentă.

Tip: String
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False
-Port

Specifică portul de rețea de pe computerul la distanță, care este folosit pentru această conexiune., Pentru a vă conecta la computerul aremote, computerul de la distanță trebuie să asculte pe portul pe care îl utilizează conexiunea. Porturile implicite sunt 5985, care este portul WinRM pentru HTTP, și 5986, care este portul WinRM pentru https.

înainte de a utiliza un alt port, trebuie să configurați ascultătorul WinRM pe computerul de la distanță pentru a ascultaacest port. Utilizați următoarele comenzi pentru a configura ascultător:

  1. winrm delete winrm/config/listener?Address=*+Transport=HTTP
  2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

a nu se folosi parametrul Port dacă nu trebuie să., Setarea portului din Comandă se aplică tuturorcalculatoare sau sesiuni pe care rulează comanda. O setare alternativă a portului ar putea împiedica rularea comenzii pe toate computerele.

Tip: Int32
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False
-RunAsAdministrator

Indică faptul că PSSession ruleaza ca administrator.,

Tip: SwitchParameter
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False
-Sesiune

Specifică o serie de PSSession obiecte care acest cmdlet folosește ca model pentru newPSSession. Acest parametru creează noi Obiecte PSSession care au aceleași proprietăți ca și obiectele PSSession specificate.,

Introduce o variabilă care conține PSSession obiecte sau o comandă care creează sau se thePSSession obiecte, cum ar fi un New-PSSession sau Get-PSSession comandă.

obiectele PSSession rezultate au același nume de computer, nume de aplicație, URI de conexiune,port, nume de configurare, limită de accelerație și valoare Secure Sockets Layer (SSL) ca și originalele, dar au un nume de afișare diferit, ID și ID de instanță (GUID).,

Type: PSSession
Position: 0
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-SessionOption

Specifies advanced options for the session., Introduceți un obiect SessionOption, cum ar fi unul care youcreate utilizând New-PSSessionOption cmdlet, sau un tabel hash în care tastele sunt nume sessionoption și valorile sunt valori ale opțiunii sesiune.

Valorile implicite pentru opțiuni sunt determinate de valoarea $PSSessionOption preferencevariable, dacă este setat. În caz contrar, valorile implicite sunt stabilite prin opțiunile setate în sesiuneconfigurare.,

Valorile opțiunii sesiune au prioritate față de valorile implicite pentru sesiunile setate în variabila de preferință$PSSessionOption și în configurația sesiunii. Cu toate acestea, ele nu iauprecedență asupra valorilor maxime, cotelor sau limitelor stabilite în configurația sesiunii.

pentru o descriere a opțiunilor sesiunii care include valorile implicite, consultațiNew-PSSessionOption. Pentru informații despre variabila de preferință $PSSessionOption, a se vedeaabout_preference_variables. Pentru mai multe informații despre configurațiile de sesiune, consultați aboutsession_configurations.,

Type: PSSessionOption
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SSHConnection

This parameter takes an array of hashtables where each hashtable contains one or more connectionparameters needed to establish a Secure Shell (SSH) connection (HostName, Port, UserName,KeyFilePath).,

parametrii de conectare hashtable sunt aceiași cu cei definiți pentru setul de parametri pentru numele de gazdă.parametrul SSHConnection este util pentru crearea mai multor sesiuni în care fiecare sesiune necesită informații de conectare diferite.acest parametru a fost introdus în PowerShell 6.0.,

Type: Hashtable
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SSHTransport

Indicates that the remote connection is established using Secure Shell (SSH).

By default PowerShell uses Windows WinRM to connect to a remote computer., Acest comutator forcesPowerShell pentru a utiliza setul de parametri HostName pentru stabilirea unei conexiuni la distanță bazate pe SSH.acest parametru a fost introdus în PowerShell 6.0.,

Type: SwitchParameter
Accepted values: true
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Subsystem

Specifies the SSH subsystem used for the new PSSession.

This specifies the subsystem to use on the target as defined in sshd_config.,Subsistemul pornește o versiune specifică a PowerShell cu parametri predefiniți.Dacă subsistemul specificat nu există pe computerul de la distanță, comanda eșuează.

dacă acest parametru nu este utilizat, implicit este subsistemul „powershell”.,

Tip: String
Poziție: Nume
valoare Implicită: powershell
Accepta conducta de intrare: True
Acceptă metacaractere: False
-ThrottleLimit

Specifică numărul maxim de conexiuni simultane, care pot fi stabilite pentru a rula această comandă.Dacă omiteți acest parametru sau introduceți o valoare de 0 (zero), se utilizează valoarea implicită, 32.,

limita de accelerație se aplică numai comenzii curente, nu sesiunii sau computerului.

Tip: Int32
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False
-numele de Utilizator

Specifică un nume de utilizator pentru contul utilizat pentru a crea o sesiune de pe computerul la distanță., Metoda de autentificare a utilizatorului va depinde de modul în care Secure Shell (SSH) este configurat pe computerul de la distanță.

dacă SSH este configurat pentru autentificarea parolei de bază, atunci vi se va solicita parola de utilizator.

dacă SSH este configurat pentru autentificarea utilizatorului pe bază de cheie, atunci o cale de fișier cheie poate fi furnizată prin parametrul theKeyFilePath și nu va apărea nicio solicitare de parolă. Rețineți că, dacă fișierul cheie Utilizator client islocated într-o locație cunoscută SSH, atunci parametrul KeyFilePath nu este necesar pentru autentificarea bazată pe cheie, iar autentificarea utilizatorului va avea loc automat pe baza numelui de utilizator., Consultați SSHdocumentation despre autentificarea utilizatorului bazată pe cheie pentru mai multe informații.

acesta nu este un parametru necesar. Dacă nu este specificat niciun parametru de nume de utilizator, atunci pentru conexiune se utilizează jurnalul curent de nume de utilizator.acest parametru a fost introdus în PowerShell 6.0.,

Tip: String
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: False
Acceptă metacaractere: False

-UseSSL

Indică faptul că acest cmdlet folosește protocolul SSL pentru a stabili o conexiune de la distanță computer.By default, SSL nu este folosit.WS-Management criptează tot conținutul PowerShell transmis prin rețea., UseSSLparameter oferă o protecție suplimentară care trimite datele printr-o conexiune HTTPS în loc deo conexiune HTTP.

Dacă utilizați acest parametru, dar SSL nu este disponibil pe portul utilizat pentru comandă, Comanda eșuează.,e

Accept wildcard characters: False
-UseWindowsPowerShell

{{ Fill UseWindowsPowerShell Description }}

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VMId

Specifies an array of ID of virtual machines., Acest cmdlet începe o sesiune interactivă cu fiecare dintre elemașini virtuale specificate., To see the virtual machines that are available to you, use thefollowing command:

Get-VM | Select-Object -Property Name, ID

Type: Guid
Aliases: VMGuid
Position: 0
Default value: None
Accept pipeline input: True
Accept wildcard characters: False
-VMName

Specifies an array of names of virtual machines., Acest cmdlet începe o sesiune interactivă cu fiecaredin mașinile virtuale specificate. Pentru a vedea mașinile virtuale care vă sunt disponibile, utilizați cmdlet-ulGet-VM.

Tip: String
Poziție: Nume
valoare Implicită: Nimic
Accepta conducta de intrare: True
Acceptă metacaractere: False

Intrări

Sistem.String, Sistem.URI, sistem.Managementul.Automatizare.Runspaces.,PSSession

puteți țeavă un șir, URI, sau obiect sesiune la acest cmdlet.

ieșiri

PSSession

Note

  • acest cmdlet utilizează infrastructura PowerShell remoting. Pentru a utiliza acest cmdlet, localulcomputerul și orice computere la distanță trebuie să fie configurate pentru PowerShell remoting. Pentru mai multe informații, consultați about_Remote_Requirements.
  • pentru a crea o PSSession pe computerul local, porniți PowerShell cu Run as administratoroption.,
  • când ați terminat cu PSSession, utilizațiRemove-PSSession cmdlet pentru a ștergepssession și eliberați resursele sale.
  • seturile de parametri HostName și SSHConnection au fost incluse începând cu PowerShell 6.0.Acestea au fost adăugate pentru a oferi PowerShell remoting bazat pe Secure Shell (SSH). Atât SSH andPowerShell sunt acceptate pe mai multe platforme (Windows, Linux, macOS) și PowerShell remotingwill munca pe aceste platforme unde PowerShell și SSH sunt instalate și configurate., Acest lucru esteseparat de Windows anterior doar remoting care se bazează pe WinRM și o mare parte din caracteristicile și limitările WinRMspecific nu se aplică. De exemplu, cotele bazate pe WinRM, opțiunile de sesiune, configurarea personalizată a punctului final și funcțiile de deconectare/reconectare nu sunt acceptate în prezent. Formore informații despre cum să configurați PowerShell SSH remoting, seePowerShell Remoting peste SSH.,
  • Connect-PSSession
  • Deconectați-PSSession
  • Enter-PSSession
  • Ieșire-PSSession
  • Ia-PSSession
  • Invoca-Comanda
  • de a Primi-PSSession
  • Scoateți-PSSession