Disconnect-PSSession
Megszakítja a munkamenetet.
Syntax
Session (Alapértelmezett)
Disconnect-PSSession
[-Session] <PSSession[]>
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Name
Disconnect-PSSession
-Name <String[]>
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceId
Disconnect-PSSession
-InstanceId <Guid[]>
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disconnect-PSSession
[-Id] <Int32[]>
[-IdleTimeoutSec <Int32>]
[-OutputBufferingMode <OutputBufferingMode>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Ez a parancsmag csak a Windows platformon érhető el.
A Disconnect-PSSession parancsmag leválaszt egy PowerShell-munkamenetet (PSSession), például a New-PSSession parancsmag használatával indított munkamenetet az aktuális munkamenetről. Ennek eredményeképpen a PSSession leválasztott állapotban van. Csatlakozhat a leválasztott PSSession az aktuális munkamenetből, vagy egy másik munkamenetből a helyi számítógépen vagy egy másik számítógépen.
A Disconnect-PSSession parancsmag csak az aktuális munkamenethez csatlakoztatott PSSessions nyitott leválasztja.
Disconnect-PSSession nem tudja leválasztani a hibás vagy lezárt PSSessions, illetve a parancsmaggal indított interaktív Enter-PSSession, és nem tudja leválasztani más munkamenetekhez csatlakoztatott PSSessions.
Ha leválasztott PSSessionszeretne újracsatlakozni, használja a Connect-PSSession vagy Receive-PSSession parancsmagokat.
Ha egy PSSession megszakad, a PSSession parancsai mindaddig futnak, amíg befejeződnek, kivéve, ha a PSSession túllépi az időkorlátot, vagy a PSSession parancsait egy teljes kimeneti puffer blokkolja. Az üresjárati időtúllépés módosításához használja az IdleTimeoutSec paramétert. A kimeneti pufferelési mód módosításához használja a OutputBufferingMode paramétert. A InDisconnectedSession paramétert is használhatja a Invoke-Command parancs futtatásához egy leválasztott munkamenetben.
A Leválasztott munkamenetek funkcióval kapcsolatos további információkért lásd about_Remote_Disconnected_Sessions.
Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.
Példák
1. példa – Munkamenet leválasztása név szerint
Ez a parancs leválasztja a UpdateSessionPSSession a Server01 számítógépen az aktuális munkamenetről. A parancs a Név paraméter használatával azonosítja a PSSession.
PS> Disconnect-PSSession -Name UpdateSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 UpdateSession Server01 Disconnected Microsoft.PowerShell None
A kimenet azt mutatja, hogy a kapcsolatbontási kísérlet sikeres volt. A munkamenet állapota Disconnected, és a rendelkezésre állásiNone, ami azt jelzi, hogy a munkamenet nincs elfoglalva, és újra csatlakoztatható.
2. példa – Munkamenet leválasztása egy adott számítógépről
Ez a parancs leválasztja a ITTaskPSSession a Server12 számítógépen az aktuális munkamenetről. A ITTask munkamenet az aktuális munkamenetben lett létrehozva, és a Kiszolgáló12 számítógéphez csatlakozik. A parancs a Get-PSSession parancsmaggal lekéri a munkamenetet és a Disconnect-PSSession parancsmagot a kapcsolat bontásához.
PS> Get-PSSession -ComputerName Server12 -Name ITTask |
Disconnect-PSSession -OutputBufferingMode Drop -IdleTimeoutSec 86400
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server12 Disconnected ITTasks None
A Disconnect-PSSession parancs a OutputBufferingMode paramétert használja a kimeneti mód Dropbeállításához. Ez a beállítás biztosítja, hogy a munkamenetben futó szkript továbbra is futjon, még akkor is, ha a munkamenet kimeneti puffere megtelt. Mivel a szkript egy fájlmegosztáson lévő jelentésbe írja a kimenetét, az egyéb kimenetek következmények nélkül elveszhetnek.
A parancs az IdleTimeoutSec paramétert is használja a munkamenet tétlenségi időtúllépésének 24 órára való meghosszabbításához. Ez a beállítás lehetővé teszi, hogy ez a rendszergazda vagy más rendszergazdák újra csatlakoznak a munkamenethez, és ellenőrizze, hogy a szkript futott-e, és szükség esetén hibaelhárítást végezzen.
3. példa – Több PSSessions használata több számítógépen
Ez a parancssorozat bemutatja, hogyan használható a Disconnect-PSSession parancsmag egy vállalati forgatókönyvben. Ebben az esetben egy új technikus elindít egy szkriptet egy munkamenetben egy távoli számítógépen, és problémába ütközik. A technikus leválasztja a munkamenetet, hogy egy tapasztaltabb vezető csatlakozzon a munkamenethez, és megoldhassa a problémát.
PS> $s = New-PSSession -ComputerName Srv1, Srv2, Srv30 -Name ITTask
PS> Invoke-Command $s -FilePath \\Server01\Scripts\Get-PatchStatus.ps1
PS> Get-PSSession -Name ITTask -ComputerName Srv1 | Disconnect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Srv1 Disconnected Microsoft.PowerShell None
PS> Get-PSSession -ComputerName Srv1, Srv2, Srv30 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Srv1 Disconnected Microsoft.PowerShell None
2 ITTask Srv2 Opened Microsoft.PowerShell Available
3 ITTask Srv30 Opened Microsoft.PowerShell Available
PS> Get-PSSession -ComputerName Srv1 -Name ITTask -Credential Domain01\User01
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Srv1 Disconnected Microsoft.PowerShell None
PS> $s = Connect-PSSession -ComputerName Srv1 -Name ITTask -Credential Domain01\User01
PS> Invoke-Command -Session $s {dir $HOME\Scripts\PatchStatusOutput.ps1}
PS> Invoke-Command -Session $s {mkdir $HOME\Scripts\PatchStatusOutput}
PS> Invoke-Command -Session $s -FilePath \\Server01\Scripts\Get-PatchStatus.ps1
PS> Disconnect-PSSession -Session $s
A technikus először több távoli számítógépen hoz létre munkameneteket, és minden munkamenetben futtat egy szkriptet. Az első parancs a New-PSSession parancsmaggal hozza létre a ITTask munkamenetet három távoli számítógépen. A parancs menti a munkameneteket a $s változóban. A második parancs a parancsmag Invoke-Command paraméterével futtat egy szkriptet a $s változó munkameneteiben.
Az Srv1 számítógépen futó szkript váratlan hibákat okoz. A technikus kapcsolatba lép a felettesével, és segítséget kér. A vezető arra utasítja a technikust, hogy szakítsa meg a munkamenetet, hogy kivizsgálhassa. A második parancs a Get-PSSession parancsmaggal lekéri a ITTask munkamenetet az Srv1 számítógépen, a Disconnect-PSSession parancsmag pedig leválasztja azt. Ez a parancs nem befolyásolja a többi számítógép ITTask munkameneteit.
A harmadik parancs a Get-PSSession parancsmagot használja a ITTask-munkamenetek lekéréséhez. A kimenet azt mutatja, hogy az Srv2- és Srv30-számítógépek ITTask munkameneteit nem érintette a leválasztási parancs.
A vezető bejelentkezik az otthoni számítógépére, csatlakozik a vállalati hálózatához, elindítja a PowerShellt, és a Get-PSSession parancsmag használatával lekéri a ITTask munkamenetet az Srv1 számítógépen. A technikus hitelesítő adataival fér hozzá a munkamenethez.
Ezután a kezelő a Connect-PSSession parancsmaggal csatlakozik az Srv1 számítógépen található ITTask munkamenethez. A parancs menti a munkamenetet a $s változóban.
A kezelő a Invoke-Command parancsmaggal futtat néhány diagnosztikai parancsot a munkamenetben a $s változóban. Felismeri, hogy a szkript nem sikerült, mert nem talált egy szükséges könyvtárat.
A kezelő a MkDir függvénnyel hozza létre a könyvtárat, majd újraindítja a Get-PatchStatus.ps1 szkriptet, és leválasztja a munkamenetről. A vezető jelenti az eredményeket a technikusnak, javasolja, hogy csatlakozzon újra a munkamenethez a feladatok elvégzéséhez, és kérje meg, hogy adjon hozzá egy parancsot a Get-PatchStatus.ps1 szkripthez, amely létrehozza a szükséges könyvtárat, ha az nem létezik.
4. példa – A PSSession időtúllépési értékének módosítása
Ez a példa bemutatja, hogyan lehet kijavítani egy munkamenet IdleTimeout tulajdonságának értékét, hogy az leválasztható legyen.
A munkamenetek inaktív időtúllépési tulajdonsága kritikus fontosságú a leválasztott munkamenetek szempontjából, mivel meghatározza, hogy mennyi ideig tart fenn egy leválasztott munkamenet a törlés előtt. A munkamenet létrehozásakor és leválasztásakor beállíthatja az üresjárati időtúllépési beállítást. A munkamenet tétlen időtúllépésének alapértelmezett értékei a helyi számítógépen $PSSessionOption beállítási változóban és a távoli számítógépen a munkamenet-konfigurációban vannak megadva. A munkamenethez beállított értékek elsőbbséget élveznek a munkamenet-konfigurációban beállított értékekkel szemben, de a munkamenet-konfigurációban beállított kvótákat nem lehet túllépni, például a MaxIdleTimeoutMs értéket.
PS> $Timeout = New-PSSessionOption -IdleTimeout 172800000
PS> $s = New-PSSession -Computer Server01 -Name ITTask -SessionOption $Timeout
PS> Disconnect-PSSession -Session $s
Disconnect-PSSession : The session ITTask cannot be disconnected because the specified
idle timeout value 172800(seconds) is either greater than the server maximum allowed
43200 (seconds) or less that the minimum allowed60(seconds). Choose an idle time out
value that is within the allowed range and try again.
PS> Invoke-Command -ComputerName Server01 {Get-PSSessionConfiguration Microsoft.PowerShell} |
Format-List -Property *
Architecture : 64
Filename : %windir%\system32\pwrshplugin.dll
ResourceUri : http://schemas.microsoft.com/powershell/microsoft.powershell
MaxConcurrentCommandsPerShell : 1000
UseSharedProcess : false
ProcessIdleTimeoutSec : 0
xmlns : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers : 5
lang : en-US
SupportsOptions : true
ExactMatch : true
RunAsUser :
IdleTimeoutms : 7200000
PSVersion : 3.0
OutputBufferingMode : Block
AutoRestart : false
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
MaxMemoryPerShellMB : 1024
MaxIdleTimeoutms : 2147483647
Uri : http://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion : 2
Name : microsoft.powershell
XmlRenderingType : text
Capability : {Shell}
RunAsPassword :
MaxProcessesPerShell : 15
ParentResourceUri : http://schemas.microsoft.com/powershell/microsoft.powershell
Enabled : true
MaxShells : 25
MaxShellsPerUser : 25
Permission : BUILTIN\Administrators AccessAllowed
PSComputerName : localhost
RunspaceId : aea84310-6dbf-4c21-90ac-13980039925a
PSShowComputerName : True
PS> $s.Runspace.ConnectionInfo
ConnectionUri : http://Server01/wsman
ComputerName : Server01
Scheme : http
Port : 80
AppName : /wsman
Credential :
ShellUri : http://schemas.microsoft.com/powershell/Microsoft.PowerShell
AuthenticationMechanism : Default
CertificateThumbprint :
MaximumConnectionRedirectionCount : 5
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize : 209715200
UseCompression : True
NoMachineProfile : False
ProxyAccessType : None
ProxyAuthentication : Negotiate
ProxyCredential :
SkipCACheck : False
SkipCNCheck : False
SkipRevocationCheck : False
NoEncryption : False
UseUTF16 : False
OutputBufferingMode : Drop
IncludePortInSPN : False
Culture : en-US
UICulture : en-US
OpenTimeout : 180000
CancelTimeout : 60000
OperationTimeout : 180000
IdleTimeout : 172800000
PS> Disconnect-PSSession $s -IdleTimeoutSec 43200
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
4 ITTask Server01 Disconnected Microsoft.PowerShell None
PS> $s.Runspace.ConnectionInfo.IdleTimeout
43200000
Az első parancs a New-PSSessionOption parancsmaggal hoz létre egy munkamenet-beállításobjektumot. Az IdleTimeout paraméterrel állít be 48 órás tétlenségi időtúllépést (172800000 ezredmásodperc). A parancs menti a munkamenet-beállításobjektumot a $Timeout változóba.
A második parancs a New-PSSession parancsmaggal hozza létre a ITTask munkamenetet a Server01 számítógépen. A parancs menti a munkamenetet a $s változóban. A SessionOption paraméter értéke a $Timeout változó 48 órás tétlenségi időtúllépése.
A harmadik parancs leválasztja a ITTask munkamenetet a $s változóban. A parancs meghiúsul, mert a munkamenet tétlen időtúllépési értéke meghaladja a MaxIdleTimeoutMs kvótát a munkamenet-konfigurációban. Mivel a tétlen időtúllépés csak a munkamenet leválasztása után használható, ez a szabálysértés észrevétlen marad, amíg a munkamenet használatban van.
A negyedik parancs a Invoke-Command parancsmaggal futtat egy Get-PSSessionConfiguration parancsot a Microsoft.PowerShell munkamenet-konfigurációjához a Server01 számítógépen. A parancs a Format-List parancsmaggal jeleníti meg a munkamenet-konfiguráció összes tulajdonságát egy listában. A kimenet azt mutatja, hogy a MaxIdleTimeoutMS tulajdonság, amely meghatározza a munkamenetkonfigurációt használó munkamenetek maximális engedélyezett IdleTimeout értékét, 43200000 ezredmásodperc (12 óra) lesz.
Az ötödik parancs lekéri a munkamenet munkamenetbeállítási értékeit a $s változóban. Számos munkamenet-beállítás értéke a munkamenet Runspace tulajdonságának ConnectionInfo tulajdonságának tulajdonsága. A kimenet azt mutatja, hogy a munkamenet IdleTimeout tulajdonságának értéke 172800000 ezredmásodperc (48 óra), ami sérti a MaxIdleTimeoutMs 12 órás kvótát a munkamenet-konfigurációban. Az ütközés feloldásához használhatja a ConfigurationName paramétert egy másik munkamenet-konfiguráció kiválasztásához, vagy a IdleTimeout paraméterrel csökkentheti a munkamenet tétlenségi időtúllépését.
A hatodik parancs megszakítja a munkamenetet. Az IdleTimeoutSec paraméter használatával állítja be az üresjárati időtúllépést a 12 órás maximális értékre.
A hetedik parancs lekéri a leválasztott munkamenet IdleTimeout tulajdonságának értékét, amely ezredmásodpercben van mérve. A kimenet megerősíti, hogy a parancs sikeres volt.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Id
A megadott munkamenet-azonosítóval rendelkező munkamenetek leválasztása. Írjon be egy vagy több azonosítót (vesszővel elválasztva), vagy használja a tartomány operátort (..) az azonosítók tartományának megadásához.
Egy munkamenet azonosítójának lekéréséhez használja a Get-PSSession parancsmagot. A példányazonosító a munkamenet azonosítójának tulajdonságában van tárolva.
Paramétertulajdonságok
| Típus: | Int32[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Id
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-IdleTimeoutSec
Módosítja a leválasztott PSSessiontétlen időtúllépési értékét. Adjon meg egy értéket másodpercek alatt. A minimális érték 60 (1 perc).
Az üresjárati időtúllépés határozza meg, hogy a leválasztott PSSession mennyi ideig tart fenn a távoli számítógépen. Ha az időtúllépés lejár, a PSSession törlődik.
A leválasztott PSSessions akkor is inaktívnak minősülnek, ha a parancsok a leválasztott munkamenetben futnak.
A munkamenet tétlen időtúllépésének alapértelmezett értékét a munkamenet-konfiguráció IdleTimeoutMs tulajdonságának értéke állítja be. Az alapértelmezett érték 7200000 ezredmásodperc (2 óra).
Ennek a paraméternek az értéke elsőbbséget élvez a beállítási változó $PSSessionOption tulajdonságának értékével, valamint a munkamenet-konfiguráció alapértelmezett tétlenségi időtúllépési értékével szemben. Ez az érték azonban nem haladhatja meg a munkamenet-konfiguráció MaxIdleTimeoutMs tulajdonság értékét. A MaxIdleTimeoutMs alapértelmezett értéke 12 óra (43200000 ezredmásodperc).
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 60 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-InstanceId
Megszakítja a munkameneteket a megadott példányazonosítókkal.
A példányazonosító egy GUID, amely egyedileg azonosít egy munkamenetet egy helyi vagy távoli számítógépen. A példányazonosító egyedi, még több munkamenetben is több számítógépen.
A munkamenet példányazonosítójának lekéréséhez használja a Get-PSSession parancsmagot. A példányazonosító a munkamenet InstanceID tulajdonságában van tárolva.
Paramétertulajdonságok
| Típus: | Guid[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
InstanceId
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Name
A megadott felhasználóbarát névvel rendelkező munkamenetek leválasztása. Helyettesítő karakterek használata engedélyezett.
A munkamenet rövid nevének lekéréséhez használja a Get-PSSession parancsmagot. A rövid nevet a rendszer a munkamenet Név tulajdonságában tárolja.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
Name
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-OutputBufferingMode
Meghatározza, hogyan történik a parancskimenet kezelése a leválasztott munkamenetben, ha a kimeneti puffer megtelt. Az alapértelmezett érték a Block.
Ha a leválasztott munkamenet parancsa kimenetet ad vissza, és a kimeneti puffer kitöltődik, a paraméter értéke hatékonyan meghatározza, hogy a parancs továbbra is fut-e a munkamenet leválasztásakor. A Block értéke felfüggeszti a parancsot a munkamenet újracsatlakoztatásáig. A Drop értéke lehetővé teszi a parancs befejezését, bár az adatok elveszhetnek. A Drop érték használatakor irányítsa át a parancs kimenetét egy lemezen lévő fájlba.
Az érvényes értékek a következők:
-
Block: Ha a kimeneti puffer megtelt, a végrehajtás fel van függesztve, amíg a puffer nem tiszta. -
Drop: Ha a kimeneti puffer megtelt, a végrehajtás folytatódik. Az új kimenet mentésekor a rendszer elveti a legrégebbi kimenetet. -
None: Nincs megadva kimeneti pufferelési mód. A rendszer a munkamenet-konfiguráció OutputBufferingMode tulajdonságának értékét használja a leválasztott munkamenethez.
Paramétertulajdonságok
| Típus: | OutputBufferingMode |
| Alapértelmezett érték: | Block |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Session
Leválasztja a megadott PSSessions. Adja meg PSSession objektumokat, például azokat, amelyeket a New-PSSession parancsmag visszaad. Egy PSSession objektumot is csövezhet Disconnect-PSSession.
A Get-PSSession parancsmag lekérheti az összes olyan PSSessions, amely egy távoli számítógépen leáll, beleértve a leválasztott PSSessions és a más számítógépeken lévő munkamenetekhez csatlakoztatott PSSessions.
Disconnect-PSSession csak az aktuális munkamenethez csatlakoztatott PSSession leválasztja. Ha más PSSessions a Disconnect-PSSession, a Disconnect-PSSession parancs meghiúsul.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Session
| Position: | 1 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-ThrottleLimit
Beállítja a Disconnect-PSSession parancs szabályozási korlátját.
A szabályozás korlátja az egyidejű kapcsolatok maximális száma, amely a parancs futtatásához hozható létre. Ha kihagyja ezt a paramétert, vagy 0értéket ad meg, a rendszer az alapértelmezett 32é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.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 32 |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSSession
Erre a parancsmagra csövezhet munkamenetet.
Kimenetek
PSSession
Ez a parancsmag egy, a leválasztott munkamenetet képviselő objektumot ad vissza.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Disconnect-PSSession:
- Windows:
dnsn
Ez a parancsmag csak Windows-platformokon érhető el.
A
Disconnect-PSSessionparancsmag csak akkor működik, ha a helyi és távoli számítógépek a PowerShell 3.0-s vagy újabb verzióját futtatják.Ha a
Disconnect-PSSessionparancsmagot leválasztott munkameneten használja, a parancsnak nincs hatása a munkamenetre, és nem okoz hibákat.Az interaktív biztonsági jogkivonatokkal rendelkező leválasztott visszacsatolási munkamenetek (az EnableNetworkAccess paraméterrel létrehozottak) csak attól a számítógéptől csatlakoztathatók újra, amelyen a munkamenet létrejött. Ez a korlátozás védi a számítógépet a rosszindulatú hozzáféréstől.
Ha leválaszt egy PSSession, a munkamenet állapota
Disconnected, a rendelkezésre állás pedig Nincs.Az State tulajdonság értéke az aktuális munkamenethez viszonyítva van. Ezért a
Disconnectedértéke azt jelenti, hogy a PSSession nincs csatlakoztatva az aktuális munkamenethez. Ez azonban nem jelenti azt, hogy a PSSession leválasztva van az összes munkamenetről. Lehet, hogy egy másik munkamenethez csatlakozik. Annak megállapításához, hogy tud-e csatlakozni vagy újra csatlakozni a munkamenethez, használja a Rendelkezésre állási tulajdonságot.A rendelkezésre állási értéke
Noneazt jelzi, hogy csatlakozhat a munkamenethez. ABusyértéke azt jelzi, hogy nem tud csatlakozni a PSSession, mert egy másik munkamenethez van csatlakoztatva.A munkamenetek State tulajdonságának értékeiről további információt RunspaceState Enumerationcímű témakörben talál.
A munkamenetek
Rendelkezésre állási tulajdonságának értékeiről a RunspaceAvailability Enumerationcíműtalál további információt.
Kapcsolódó hivatkozások
- Connect-PSSession (kapcsolódás PowerShell munkamenethez)
- Enter-PSSession (PowerShell parancs a távoli számítógéppel való interaktív munkamenet indítására)
- Exit-PSSession
- Get-PSSession
- Get-PSSessionConfiguration (PSSession konfiguráció lekérése)
- New-PSSession
- New-PSSessionOption
- New-PSTransportOption
- Receive-PSSession
- Register-PSSessionConfiguration
- Remove-PSSession parancs eltávolít egy PSSession-t
- PSSessions témakörről
- about_Távvezérlés
- about_Távoli_Szétkapcsolt_Munkamenetek