New-PSSession
Állandó kapcsolatot hoz létre egy helyi vagy távoli számítógéppel.
Syntax
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>]New-PSSession
[-Credential <PSCredential>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ConfigurationName <String>]
[-ThrottleLimit <Int32>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
[-SessionOption <PSSessionOption>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[<CommonParameters>]New-PSSession
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
[-VMId] <Guid[]>
[-ThrottleLimit <Int32>]
[<CommonParameters>]New-PSSession
-Credential <PSCredential>
[-Name <String[]>]
[-ConfigurationName <String>]
-VMName <String[]>
[-ThrottleLimit <Int32>]
[<CommonParameters>]New-PSSession
[[-Session] <PSSession[]>]
[-Name <String[]>]
[-EnableNetworkAccess]
[-ThrottleLimit <Int32>]
[<CommonParameters>]New-PSSession
[-Name <String[]>]
[-ConfigurationName <String>]
-ContainerId <String[]>
[-RunAsAdministrator]
[-ThrottleLimit <Int32>]
[<CommonParameters>]Description
A New-PSSession parancsmag létrehoz egy PowerShell-munkamenetet (PSSession) egy helyi vagy távoli számítógépen. PSSession létrehozásakor a PowerShell állandó kapcsolatot létesít a távoli számítógéppel.
PsSession használatával több olyan parancsot futtathat, amelyek adatokat osztanak meg, például egy függvényt vagy egy változó értékét. A parancsok PSSession-ben való futtatásához használja a Invoke-Command parancsmagot. Ha a PSSession használatával közvetlenül szeretne kommunikálni egy távoli számítógéppel, használja a Enter-PSSession parancsmagot. További információ: about_PSSessions.
Parancsokat futtathat távoli számítógépen PSSession létrehozása nélkül a Számítógépnév vagy Invoke-CommandEnter-PSSession a . A ComputerName paraméter használatakor a PowerShell létrehoz egy ideiglenes kapcsolatot, amelyet a parancs használ, majd bezár.
Példák
1. példa: Munkamenet létrehozása a helyi számítógépen
$s = New-PSSessionEz a parancs létrehoz egy új PSSession-t a helyi számítógépen, és menti a PSSessiont a $s változóba.
Ezzel a PSSession használatával parancsokat futtathat a helyi számítógépen.
2. példa: Munkamenet létrehozása távoli számítógépen
$Server01 = New-PSSession -ComputerName Server01Ez a parancs létrehoz egy új PSSession-t a Server01 számítógépen, és menti a $Server01 változóba.
Több PSSession-objektum létrehozásakor rendelje hozzá őket hasznos névvel rendelkező változókhoz. Ez segít kezelni a PSSession objektumokat a következő parancsokban.
3. példa: Munkamenetek létrehozása több számítógépen
$s1, $s2, $s3 = New-PSSession -ComputerName Server01,Server02,Server03Ez a parancs három PSSession objektumot hoz létre, egyet a ComputerName paraméter által megadott számítógépeken.
A parancs a hozzárendelési operátort (=) használja az új PSSession-objektumok változókhoz való hozzárendeléséhez: $s1, , $s2$s3. Hozzárendeli a Server01 PSSession-t$s1, a Server02 PSSession-t $s2és a Server03 PSSession-t.$s3
Ha több objektumot rendel egy változósorozathoz, a PowerShell az egyes objektumokat az adatsor egy változóhoz rendeli. Ha több objektum van, mint változó, a rendszer az összes többi objektumot az utolsó változóhoz rendeli hozzá. Ha az objektumoknál több változó van, a fennmaradó változók üresek ($null).
4. példa: Munkamenet létrehozása megadott porttal
New-PSSession -ComputerName Server01 -Port 8081 -UseSSL -ConfigurationName E12Ez a parancs létrehoz egy új PSSession-t a Kiszolgáló01 számítógépen, amely csatlakozik a kiszolgálóporthoz 8081 , és az SSL protokollt használja. Az új PSSession egy másik, úgynevezett munkamenet-konfigurációt E12használ.
A port beállítása előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen a 8081-s port figyelésére. További információt a Port paraméter leírásában talál.
5. példa: Munkamenet létrehozása meglévő munkamenet alapján
New-PSSession -Session $s -Credential Domain01\User01Ez a parancs olyan PSSession-t hoz létre, amely ugyanazokkal a tulajdonságokkal rendelkezik, mint egy meglévő PSSession. Ezt a parancsformátumot akkor használhatja, ha egy meglévő PSSession erőforrásai kimerültek, és új PSSession szükséges az igény egy részének kiszervezéséhez.
A parancs a Munkamenet paramétert New-PSSession használja a változóban mentett PSSession megadásához$s. A parancs végrehajtásához a Domain1\Admin01 felhasználó hitelesítő adatait használja.
6. példa: Munkamenet létrehozása globális hatókörrel egy másik tartományban
$global:s = New-PSSession -ComputerName Server1.Domain44.Corpnet.Fabrikam.com -Credential Domain01\Admin01Ez a példa bemutatja, hogyan hozhat létre psSession-t globális hatókörrel egy másik tartományban lévő számítógépen.
Alapértelmezés szerint a parancssorban létrehozott PSSession-objektumok helyi hatókörrel, a szkriptekben létrehozott PSSession-objektumok pedig szkripthatókörrel rendelkeznek.
Ha globális hatókörű PSSessiont szeretne létrehozni, hozzon létre egy új PSSessiont, majd tárolja a PSSessiont egy globális hatókörbe leadott változóban. Ebben az esetben a $s változó globális hatókörbe kerül.
A parancs a ComputerName paramétert használja a távoli számítógép megadásához. Mivel a számítógép más tartományban van, mint a felhasználói fiók, a számítógép teljes neve a felhasználó hitelesítő adataival együtt van megadva.
7. példa: Munkamenetek létrehozása számos számítógéphez
$rs = Get-Content C:\Test\Servers.txt | New-PSSession -ThrottleLimit 50Ez a parancs létrehoz egy PSSession-t a fájlban Servers.txt felsorolt 200 számítógépen, és az eredményül kapott PSSessiont a $rs változóban tárolja. A PSSession objektumok szabályozható korlátja a 50.
Ezt a parancsformátumot akkor használhatja, ha a számítógépek neve adatbázisban, számolótáblában, szövegfájlban vagy más szövegkonvertáló formátumban van tárolva.
8. példa: Munkamenet létrehozása URI használatával
$s = New-PSSession -URI http://Server01:91/NewSession -Credential Domain01\User01Ez a parancs létrehoz egy PSSession-t a Server01 számítógépen, és tárolja a $s változóban. Az URI paraméter használatával adja meg az átviteli protokollt, a távoli számítógépet, a portot és egy alternatív munkamenet-konfigurációt. Emellett a Hitelesítő adatok paramétert használja egy olyan felhasználói fiók megadására, amely jogosult munkamenet létrehozására a távoli számítógépen.
9. példa: Háttérfeladat futtatása munkamenetek halmazában
$s = New-PSSession -ComputerName (Get-Content Servers.txt) -Credential Domain01\Admin01 -ThrottleLimit 16
Invoke-Command -Session $s -ScriptBlock {Get-Process PowerShell} -AsJobEzek a parancsok PSSession-objektumok készletét hozzák létre, majd futtatnak egy háttérfeladatot az egyes PSSession-objektumokban.
Az első parancs létrehoz egy új PSSession-t a fájlban Servers.txt felsorolt összes számítógépen. A parancsmag használatával New-PSSession hozza létre a PSSessiont. A ComputerName paraméter értéke egy parancs, amely a Get-Content parancsmagot használja a fájl számítógépneveinek listájának lekéréséhezServers.txt.
A parancs a Hitelesítő paraméterrel hozza létre a tartományi rendszergazda engedélyével rendelkező PSSession-objektumokat , és a ThrottleLimit paraméterrel korlátozza a parancsot az egyidejű kapcsolatokra 16 . A parancs menti a PSSession objektumokat a $s változóban.
A második parancs a parancsmag AsJob paraméterével Invoke-Command indít el egy háttérfeladatot, amely egy Get-Process PowerShell parancsot futtat az egyes PSSession-objektumokban$s.
További információ a PowerShell háttérfeladatairól: about_Jobs és about_Remote_Jobs.
10. példa: Munkamenet létrehozása számítógéphez az URI használatával
New-PSSession -ConnectionURI https://management.exchangelabs.com/ManagementEz a parancs létrehoz egy PSSession objektumot, amely számítógépnév helyett egy URI által megadott számítógéphez csatlakozik.
11. példa: Munkamenet-beállítás létrehozása
$so = New-PSSessionOption -SkipCACheck
New-PSSession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -Credential Server01\Admin01Ez a példa bemutatja, hogyan hozhat létre munkamenet-beállításobjektumot, és hogyan használhatja a SessionOption paramétert .
Az első parancs a New-PSSessionOption parancsmaggal hoz létre egy munkamenet-beállítást. Menti az eredményül kapott SessionOption objektumot a $so változóban.
A második parancs egy új munkamenetben használja a lehetőséget. A parancs a New-PSSession parancsmaggal hoz létre egy új munkamenetet. A SessionOption paraméter értéke a változó SessionOption objektuma$so.
Paraméterek
-AllowRedirection
Azt jelzi, hogy ez a parancsmag lehetővé teszi a kapcsolat átirányítását egy alternatív egységes erőforrás-azonosítóra (URI).
A ConnectionURI paraméter használatakor a távoli cél egy utasítást adhat vissza egy másik URI-ra való átirányításhoz. A PowerShell alapértelmezés szerint nem irányítja át a kapcsolatokat, de ezzel a paramétersel engedélyezheti a kapcsolat átirányítását.
A MaximumConnectionRedirectionCount munkamenet beállításértékének módosításával azt is korlátozhatja, hogy a rendszer hányszor irányítsa át a kapcsolatot. Használja a parancsmag MaximumRedirection paraméterétNew-PSSessionOption, vagy állítsa be a $PSSessionOption beállítási változó MaximumConnectionRedirectionCount tulajdonságát. Az alapértelmezett érték 5.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ApplicationName
Megadja a kapcsolati URI alkalmazásnév-szegmensét. Ezzel a paraméterrel adhatja meg az alkalmazás nevét, ha nem használja a ConnectionURI paramétert a parancsban.
Az alapértelmezett érték a helyi számítógépen található $PSSessionApplicationName beállítási változó értéke. Ha ez a beállításváltozó nincs definiálva, az alapértelmezett érték az WSMAN. Ez az érték a legtöbb felhasználáshoz megfelelő. További információ: about_Preference_Variables.
A WinRM szolgáltatás az alkalmazás nevével választ ki egy figyelőt a kapcsolatkérés kiszolgálásához. A paraméter értékének meg kell egyeznie a távoli számítógépen lévő figyelő URLPrefix tulajdonságának értékével.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Authentication
Megadja a felhasználó hitelesítő adatainak hitelesítéséhez használt mechanizmust. A paraméter elfogadható értékei a következők:
DefaultBasicCredsspDigestKerberosNegotiateNegotiateWithImplicitCredential
Az alapértelmezett érték Default.
A paraméter értékeivel kapcsolatos további információkért lásd : AuthenticationMechanism Enumeration.
Figyelemfelhívás
A hitelesítő adatok biztonsági támogatási szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatokkal szabályozható a hálózati munkamenet.
| Típus: | AuthenticationMechanism |
| Elfogadott értékek: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-CertificateThumbprint
Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult a művelet végrehajtására. Adja meg a tanúsítvány ujjlenyomatát.
A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le; nem működnek tartományi fiókokkal.
Tanúsítvány beszerzéséhez használja a Get-Item PowerShell-meghajtón Cert: található parancsot.Get-ChildItem
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ComputerName
A számítógépek nevének tömbje. Ez a parancsmag állandó kapcsolatot (PSSession) hoz létre a megadott számítógéppel. Ha több számítógépnevet ad meg, New-PSSession több PSSession objektumot hoz létre, egyet minden számítógéphez. Alapértelmezés szerint a helyi számítógép.
Írja be egy vagy több távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyi számítógép megadásához írja be a számítógép nevét vagy localhostpontját (.). Ha a számítógép más tartományban van, mint a felhasználó, a teljes tartománynévre van szükség.
A számítógép nevét idézőjelek között is becsúszthatja a következőre New-PSSession: .
Ha IP-címet szeretne használni a ComputerName paraméter értékében, a parancsnak tartalmaznia kell a hitelesítő adatot. Emellett a számítógépet HTTPS-átvitelre kell konfigurálni, vagy a távoli számítógép IP-címét fel kell venni a helyi számítógép WinRM TrustedHosts listájába. A számítógépnév TrustedHosts-listához való hozzáadására vonatkozó utasításokért tekintse meg a about_Remote_Troubleshooting "Számítógép hozzáadása a megbízható gazdagéplistához" című témakört.
Ha a helyi számítógépet fel szeretné venni a ComputerName paraméter értékére, indítsa el a Windows PowerShellt a Futtatás rendszergazdaként lehetőséggel.
| Típus: | String[] |
| Aliasok: | Cn |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ConfigurationName
Megadja az új PSSession-hez használt munkamenet-konfigurációt.
Adja meg a konfiguráció nevét vagy a munkamenet-konfiguráció teljes erőforrás-URI-címét. Ha csak a konfiguráció nevét adja meg, a rendszer a következő séma URI-ját előpendálta: http://schemas.microsoft.com/PowerShell.
Egy munkamenet munkamenet-konfigurációja a távoli számítógépen található. Ha a megadott munkamenet-konfiguráció nem létezik a távoli számítógépen, a parancs meghiúsul.
Az alapértelmezett érték a helyi számítógépen található $PSSessionConfigurationName beállítási változó értéke. Ha ez a beállítási változó nincs beállítva, az alapértelmezett érték a következő Microsoft.PowerShell. További információ: about_Preference_Variables.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ConnectionUri
Egy URI-t ad meg, amely meghatározza a munkamenet kapcsolati végpontjait. Az URI-nak teljes mértékben minősítettnek kell lennie. A sztring formátuma a következő:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Az alapértelmezett érték a következő:
http://localhost:5985/WSMAN
Ha nem ad meg ConnectionURI-t, a ConnectionURI-értékek megadásához használhatja a UseSSL, a ComputerName, a Port és az ApplicationName paramétereket.
Az URI átviteli szegmensének érvényes értékei a HTTP és a HTTPS. Ha egy átviteli szegmenshez tartozó kapcsolati URI-t ad meg, de nem ad meg portot, a munkamenet szabványportokkal jön létre: 80 HTTP-hez és 443 HTTPS-hez. A PowerShell-újraküldés alapértelmezett portjának használatához adja meg a HTTP-portot 5985 vagy 5986 a HTTPS-t.
Ha a célszámítógép átirányítja a kapcsolatot egy másik URI-ra, a PowerShell megakadályozza az átirányítást, hacsak nem használja az AllowRedirection paramétert a parancsban.
| Típus: | Uri[] |
| Aliasok: | URI, CU |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ContainerId
Tárolók azonosítóinak tömbje. Ez a parancsmag egy interaktív munkamenetet indít el a megadott tárolókkal. docker ps A parancs használatával lekérheti a tárolóazonosítók listáját. További információt a docker ps parancs súgójában talál.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a művelet végrehajtásához engedéllyel. Alapértelmezés szerint az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01adjon meg egy, a Get-Credential parancsmag által létrehozott PSCredential objektumot. Ha beír egy felhasználónevet, a rendszer kéri a jelszó megadását.
A hitelesítő adatokat PSCredential objektum tárolja, a jelszót pedig SecureStringként tárolja a rendszer.
Feljegyzés
További információ a SecureString adatvédelemről: Mennyire biztonságos a SecureString?.
| Típus: | PSCredential |
| Position: | Named |
| Alapértelmezett érték: | Current user |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-EnableNetworkAccess
Azt jelzi, hogy ez a parancsmag egy interaktív biztonsági jogkivonatot ad hozzá a visszacsatolási munkamenetekhez. Az interaktív jogkivonat segítségével parancsokat futtathat a visszacsatolási munkamenetben, amelyek adatokat kapnak más számítógépekről. Futtathat például egy parancsot a munkamenetben, amely XML-fájlokat másol egy távoli számítógépről a helyi számítógépre.
A visszacsatolási munkamenet olyan PSSession , amely ugyanahhoz a számítógéphez kapcsolódik és végződik. Visszacsatolási munkamenet létrehozásához hagyja ki a ComputerName paramétert, vagy állítsa az értékét pont (.) localhostértékre vagy a helyi számítógép nevére.
Ez a parancsmag alapértelmezés szerint egy hálózati jogkivonat használatával hozza létre a visszacsatolási munkameneteket, ami nem feltétlenül biztosít elegendő engedélyt a távoli számítógépek hitelesítéséhez.
Az EnableNetworkAccess paraméter csak visszacsatolási munkamenetekben érvényes. Ha az EnableNetworkAccess szolgáltatást használja, amikor munkamenetet hoz létre egy távoli számítógépen, a parancs sikeres lesz, de a paraméter figyelmen kívül lesz hagyva.
A visszacsatolási munkamenetekben CredSSP a távelérést a hitelesítési paraméter értékével is engedélyezheti, amely a munkamenet hitelesítő adatait más számítógépekre delegálja.
A számítógép rosszindulatú hozzáférés elleni védelme érdekében az interaktív jogkivonatokkal rendelkező leválasztott visszacsatolási munkamenetek, amelyek az EnableNetworkAccess paraméter használatával lettek létrehozva, csak attól a számítógéptől csatlakoztathatók újra, amelyen a munkamenet létre lett hozva. A CredSSP-hitelesítést használó leválasztott munkamenetek újra csatlakoztathatók más számítógépekről. További információ: Disconnect-PSSession.
Ezt a paramétert a PowerShell 3.0-ban vezettük be.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Name
A PSSession rövid nevét adja meg.
A névvel hivatkozhat a PSSession-ra , ha más parancsmagokat használ, például Get-PSSession és Enter-PSSession. A névnek nem kell egyedinek lennie a számítógépen vagy az aktuális munkamenetben.
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Port
A kapcsolathoz használt hálózati portot adja meg a távoli számítógépen. Távoli számítógéphez való csatlakozáshoz a távoli számítógépnek a kapcsolat által használt portot kell figyelnie. Az alapértelmezett portok 5985a HTTP WinRM-portja, és 5986a HTTPS WinRM-portja.
Egy másik port használata előtt konfigurálnia kell a WinRM-figyelőt a távoli számítógépen az adott port figyelésére. A figyelő konfigurálásához használja az alábbi parancsokat:
winrm delete winrm/config/listener?Address=*+Transport=HTTPwinrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}
Csak akkor használja a Port paramétert, ha kötelező. A parancs portbeállítása minden olyan számítógépre vagy munkamenetre vonatkozik, amelyen a parancs fut. Egy másik portbeállítás megakadályozhatja, hogy a parancs minden számítógépen fusson.
| Típus: | Int32 |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-RunAsAdministrator
Azt jelzi, hogy a PSSession rendszergazdaként fut.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Session
A parancsmag által az új PSSession modelljeként használt PSSession-objektumok tömbje. Ez a paraméter új PSSession objektumokat hoz létre, amelyek a megadott PSSession objektumokkal azonos tulajdonságokkal rendelkeznek.
Adjon meg egy változót, amely tartalmazza a PSSession objektumokat, vagy egy olyan parancsot, amely létrehozza vagy lekéri a PSSession objektumokat, például egy New-PSSession vagy Get-PSSession egy parancsot.
Az eredményül kapott PSSession-objektumok a számítógép nevével, az alkalmazás nevével, a kapcsolati URI-val, a porttal, a konfiguráció nevével, a szabályozáskorláttal és a Secure Sockets Layer (SSL) értékével megegyeznek az eredetivel, de eltérő megjelenítendő névvel, azonosítóval és példányazonosítóval (GUID) rendelkeznek.
| Típus: | PSSession[] |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-SessionOption
A munkamenet speciális beállításait adja meg. Adjon meg egy SessionOption objektumot, például a parancsmaggal New-PSSessionOption létrehozott objektumot, vagy egy kivonattáblát, amelyben a kulcsok munkamenet-beállításnevek, az értékek pedig munkamenet-beállításértékek.
A beállítások alapértelmezett értékeit a beállítási változó értéke $PSSessionOption határozza meg, ha be van állítva. Ellenkező esetben az alapértelmezett értékeket a munkamenet-konfigurációban megadott beállítások állítják be.
A munkamenet-beállításértékek elsőbbséget élveznek a beállításváltozóban és a $PSSessionOption munkamenet-konfigurációban beállított munkamenetek alapértelmezett értékeivel szemben. Azonban nem elsőbbséget élveznek a munkamenet-konfigurációban beállított maximális értékekkel, kvótával vagy korlátokkal szemben.
Az alapértelmezett értékeket tartalmazó munkamenet-beállítások leírását lásd: New-PSSessionOption. A beállítási változóval kapcsolatos információkért $PSSessionOption lásd : about_Preference_Variables. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.
| Típus: | PSSessionOption |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-ThrottleLimit
Megadja a parancs futtatásához létrehozható egyidejű kapcsolatok maximális számát.
Ha kihagyja ezt a paramétert, vagy egy (nulla) értéket 0 ad meg, 32akkor a rendszer az alapértelmezett értéket használja.
A szabályozás korlátja csak az aktuális parancsra vonatkozik, a munkamenetre és a számítógépre nem.
| Típus: | Int32 |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-UseSSL
Azt jelzi, hogy ez a parancsmag az SSL protokoll használatával hoz létre kapcsolatot a távoli számítógéppel. Alapértelmezés szerint az SSL nem használatos.
A WS-Management a hálózaton keresztül továbbított összes PowerShell-tartalmat titkosítja. A UseSSL paraméter további védelmet nyújt, amely HTTP-kapcsolat helyett HTTPS-kapcsolaton keresztül küldi az adatokat.
Ha ezt a paramétert használja, de az SSL nem érhető el a parancshoz használt porton, a parancs meghiúsul.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | False |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-VMId
Virtuálisgép-azonosítók tömbje. Ez a parancsmag elindít egy PowerShell Direct interaktív munkamenetet az egyes megadott virtuális gépeken. További információ: Virtuális gépek automatizálása és kezelése a PowerShell használatával.
A Hyper-V-gazdagépen elérhető virtuális gépek megtekintésére használható Get-VM .
| Típus: | Guid[] |
| Aliasok: | VMGuid |
| Position: | 0 |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-VMName
A virtuális gépek nevének tömbje. Ez a parancsmag elindít egy PowerShell Direct interaktív munkamenetet az egyes megadott virtuális gépeken. További információ: Virtuális gépek automatizálása és kezelése a PowerShell használatával.
A Hyper-V-gazdagépen elérhető virtuális gépek megtekintésére használható Get-VM .
| Típus: | String[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
Bevitelek
Erre a parancsmagra sztringet csövezhet.
System.URI
Ehhez a parancsmaghoz URI-t csövezhet.
Erre a parancsmagra egy munkamenet-objektumot csövezhet.
Kimenetek
Jegyzetek
A Windows PowerShell a következő aliasokat New-PSSessiontartalmazza:
nsnEz a parancsmag a PowerShell-remoting infrastruktúrát használja. A parancsmag használatához konfigurálni kell a helyi számítógépet és a távoli számítógépeket a PowerShell-újraküldéshez. További információ: about_Remote_Requirements.
Ha PSSessiont szeretne létrehozni a helyi számítógépen, indítsa el a PowerShellt a Futtatás rendszergazdaként beállítással.
Ha befejezte a PSSession használatát, a
Remove-PSSessionparancsmaggal törölje a PSSessiont , és engedje fel az erőforrásait.
