Disconnect-PSSession

Modul:: Microsoft.PowerShell.Core Module

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

A Disconnect-PSSession parancsmag leválasztja a 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. A leválasztott PSSessionhoz csatlakozhat az aktuális munkamenetből, vagy a helyi számítógép vagy egy másik számítógép egy másik munkamenetéből.

A Disconnect-PSSession parancsmag csak az aktuális munkamenethez csatlakoztatott nyitott PSSessions leválasztja. Disconnect-PSSession nem tudja leválasztani a megszakadt vagy lezárt PSSessions vagy a Enter-PSSession parancsmaggal elindított interaktív PSSessions funkciókat, és nem tudja leválasztani a más munkamenetekhez kapcsolódó PSSessions protokollokat.

Ha újra szeretne csatlakozni egy leválasztott PSSessionhoz, használja a vagy Connect-PSSession parancsmagokatReceive-PSSession.

Ha egy PSSession leválasztja, a PSSession parancsai a befejezésükig futnak, kivéve, ha a PSSession időtúllépést okoz, 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 az UpdateSession PSSession szolgáltatást a Server01 számítógépen az aktuális munkamenetről. A parancs a Name paraméterrel azonosítja a PSSessiont.

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 Leválasztva, a Rendelkezésre állás pedig Nincs, ami azt jelzi, hogy a munkamenet nem foglalt, és újra csatlakoztatható.

2. példa – Munkamenet leválasztása egy adott számítógépről

Ez a parancs leválasztja a Server12 számítógépen futó ITTask PSSession-t az aktuális munkamenetről. Az ITTask munkamenet az aktuális munkamenetben jött létre, és csatlakozik a Server12 számítógéphez. 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 az OutputBufferingMode paraméterrel állítja be a kimeneti módot Drop értékre. 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 parancsmag használatával hozza létre az ITTask munkamenetet három távoli számítógépen. A parancs a $s változóba menti a munkameneteket. A második parancs a parancsmag FilePath paraméterével Invoke-Command 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 menedzser utasítja a technikust, hogy szakítsa meg a kapcsolatot a munkamenettel, hogy kivizsgálhassa. A második parancs a Get-PSSession parancsmag használatával lekéri az ITTask munkamenetet az Srv1 számítógépen, és a Disconnect-PSSession parancsmagot leválasztja arról. Ez a parancs nincs hatással a többi számítógépen lévő ITTask munkamenetekre.

A harmadik parancs a Get-PSSession parancsmag használatával kapja meg az ITTask munkameneteket. A kimenet azt mutatja, hogy az Srv2 és Srv30 számítógépeken az ITTask munkameneteket nem befolyásolta a leválasztási parancs.

A kezelő bejelentkezik az otthoni számítógépére, csatlakozik a vállalati hálózathoz, elindítja a Windows PowerShellt, és a Get-PSSession parancsmag segítségével lekéri az 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 ITTask munkamenethez az Srv1 számítógépen. 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                   : https://schemas.microsoft.com/powershell/microsoft.powershell
MaxConcurrentCommandsPerShell : 1000
UseSharedProcess              : false
ProcessIdleTimeoutSec         : 0
xmlns                         : https://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                           : https://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion                    : 2
Name                          : microsoft.powershell
XmlRenderingType              : text
Capability                    : {Shell}
RunAsPassword                 :
MaxProcessesPerShell          : 15
ParentResourceUri             : https://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                          : https://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. A paraméter használatával 48 órás (172800000 ezredmásodperces) üresjárati időtúllépést állít be. A parancs a munkamenet beállításobjektumát a $Timeout változóba menti.

A második parancs a New-PSSession parancsmag használatával hozza létre az ITTask munkamenetet a Server01 számítógépen. A parancs menti a munkamenetet a $s változóba. A SessionOption paraméter értéke a $Timeout változó 48 órás üresjárati időkorlátja.

A harmadik parancs leválasztja az 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 parancsmag használatával futtat egy Get-PSSessionConfiguration parancsot a Microsoft.PowerShell munkamenet-konfigurációhoz a Server01 számítógépen. A parancs a Format-List parancsmag használatával jeleníti meg a munkamenet-konfiguráció összes tulajdonságát egy listában. A kimenet azt mutatja, hogy a MaxIdleTimeoutMS tulajdonság, amely a munkamenet-konfigurációt használó munkamenetek maximálisan engedélyezett IdleTimeout értékét határozza meg, 43200000 ezredmásodperc (12 óra).

Az ötödik parancs lekéri a munkamenet munkamenet-beá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ágai. A kimenet azt mutatja, hogy a munkamenet IdleTimeout tulajdonságának értéke 172800000 ezredmásodperc (48 óra), ami megsérti a MaxIdleTimeoutMs 12 órás kvótát a munkamenet-konfigurációban. Az ütközés feloldásához a ConfigurationName paraméterrel kiválaszthat egy másik munkamenet-konfigurációt, vagy az IdleTimeout paraméterrel csökkentheti a munkamenet üresjárati 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

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 PSSession üresjárati 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 maradjon fenn a távoli számítógépen. Az időkorlát lejártakor a PSSession törlődik.

A leválasztott PSSessions a kapcsolat megszakításának pillanatától kezdve tétlennek minősül, még akkor is, ha a leválasztott munkamenetben parancsok 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 72000000 ezredmásodperc (2 óra).

Ennek a paraméternek az értéke elsőbbséget élvez a $PSSessionOption beállításváltozó IdleTimeout tulajdonságának értékével és a munkamenet-konfiguráció alapértelmezett üresjárati 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 Blokk.

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 Blokk érték felfüggeszti a parancsot a munkamenet újracsatlakozásáig. A Drop érték 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:

Blokk: 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.
Nincs: Nincs kimeneti pufferelési mód megadva. 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-okat. Adja meg a PSSession objektumokat, például azokat, amelyeket a New-PSSession parancsmag ad vissza. A PSSession-objektumot a következőre Disconnect-PSSessionis átirányíthatja: .

A Get-PSSession parancsmag képes lekérni az összes távoli számítógépen végződő PSSessiont, beleértve a leválasztott PSSessionokat és a más számítógépek más munkameneteihez csatlakoztatott PSSessionokat is. Disconnect-PSSession csak az aktuális munkamenethez kapcsolódó PSSession kapcsolatot választja le. Ha más PSSessionokat irányít a Disconnect-PSSession, a Disconnect-PSSession parancs sikertelen lesz.

Paramétertulajdonságok

Típus:	PSSession[]
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

A munkamenetet a következőre Disconnect-PSSessionirányíthatja: .

Kimenetek

PSSession

Disconnect-PSSession Olyan objektumot ad vissza, amely a leválasztott munkamenetet jelöli.

Jegyzetek

A Disconnect-PSSession parancsmag 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-PSSession parancsmagot 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.
A PSSession leválasztásakor a munkamenet állapota Leválasztva, és a rendelkezésre állás Nincs.

Az State tulajdonság értéke az aktuális munkamenethez viszonyítva van. Ezért a leválasztott é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 Nincs azt jelzi, hogy csatlakozhat a munkamenethez. Az Foglalt érték azt jelzi, hogy nem tud csatlakozni a PSSessionhoz, 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.

Megosztás a következőn keresztül:

Disconnect-PSSession

Syntax

Session (Alapértelmezett)

Name

InstanceId

Id

Description

Példák

1. példa – Munkamenet leválasztása név szerint

2. példa – Munkamenet leválasztása egy adott számítógépről

3. példa – Több PSSessions használata több számítógépen

4. példa – A PSSession időtúllépési értékének módosítása

Paraméterek

-Confirm

Paramétertulajdonságok

Paraméterkészletek

-Id

Paramétertulajdonságok

Paraméterkészletek

-IdleTimeoutSec

Paramétertulajdonságok

Paraméterkészletek

-InstanceId

Paramétertulajdonságok

Paraméterkészletek

-Name

Paramétertulajdonságok

Paraméterkészletek

-OutputBufferingMode

Paramétertulajdonságok

Paraméterkészletek

-Session

Paramétertulajdonságok

Paraméterkészletek

-ThrottleLimit

Paramétertulajdonságok

Paraméterkészletek

-WhatIf

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Bevitelek

PSSession

Kimenetek

PSSession

Jegyzetek

Kapcsolódó hivatkozások