Disconnect-PSSession

Modül:
Microsoft.PowerShell.Core Module

Oturum bağlantısını keser.

Syntax

Session (Varsayılan) 

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

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Disconnect-PSSession cmdlet'i, örneğin cmdlet'i ile başlatılan bir PowerShell oturumunun (New-PSSession) geçerli oturumla bağlantısını keser. Sonuç olarak, PSSession bağlantısı kesilmiş durumdadır. Bağlantısı kesilmiş PSSession'e, geçerli oturumdan veya yerel bilgisayarda ya da farklı bir bilgisayarda başka bir oturumdan bağlanabilirsiniz.

Disconnect-PSSession cmdlet'i yalnızca geçerli oturuma bağlı olan açık PSSessions bağlantısını keser. Disconnect-PSSession bozuk veya kapalı PSSessionsveya cmdlet'i kullanılarak başlatılmış etkileşimli Enter-PSSession bağlantısını kesemez, ayrıca diğer oturumlara bağlı PSSessions bağlantısını da kesemez.

Bağlantısı kesilmiş bir PSSession'e yeniden bağlanmak için Connect-PSSession veya Receive-PSSession cmdlet'lerini kullanın.

PSSession bağlantısı kesildiğinde, komutlar PSSession zaman aşımına uğramadığı veya PSSession içindeki komutlar tam çıkış arabelleği tarafından engellenmediği sürece PSSession içinde tamamlanana kadar çalışmaya devam eder. Boşta kalma zaman aşımını değiştirmek için IdleTimeoutSec parametresini kullanın. Çıkış arabelleği modunu değiştirmek için OutputBufferingMode parametresini kullanın. Bağlantısı kesilmiş bir oturumda komut çalıştırmak için ayrıca cmdlet'inin Invoke-Command parametresini kullanabilirsiniz.

Bağlantısı Kesilmiş Oturumlar özelliği hakkında daha fazla bilgi için bkz. about_Remote_Disconnected_Sessions.

Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.

Örnekler

Örnek 1 - Oturum bağlantısını ada göre kesme

Bu komut, Server01 bilgisayarındaki UpdateSessionPSSession geçerli oturumla bağlantısını keser. komut, PSSessiontanımlamak için Name parametresini kullanır.

PS> Disconnect-PSSession -Name UpdateSession
Id Name            ComputerName    State         ConfigurationName     Availability
-- ----            ------------    -----         -----------------     ------------
1  UpdateSession   Server01        Disconnected  Microsoft.PowerShell          None

Çıkış, bağlantıyı kesme girişiminin başarılı olduğunu gösterir. Oturum durumu Disconnected ve KullanılabilirlikNoneolup bu, oturumun meşgul olmadığını ve yeniden bağlanabilir olduğunu gösterir.

Örnek 2 - Oturumun belirli bir bilgisayarla bağlantısını kesme

Bu komut, Server12 bilgisayarındaki ITTaskPSSession geçerli oturumla bağlantısını keser. ITTask oturumu geçerli oturumda oluşturuldu ve Server12 bilgisayarına bağlanır. Komut, oturumu almak için Get-PSSession cmdlet'ini ve bağlantısını kesmek için Disconnect-PSSession cmdlet'ini kullanır.

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

Disconnect-PSSession komutu, çıkış modunu olarak ayarlamak için Drop parametresini kullanır. Bu ayar, oturum çıktı arabelleği dolu olsa bile oturumda çalışan betiğin çalışmaya devam etmesini sağlar. Betik çıktısını bir dosya paylaşımındaki bir rapora yazdığından, diğer çıktılar kaybolsa bile önemli olmayacaktır.

Komut ayrıca oturumun boşta kalma zaman aşımını 24 saate uzatmak için IdleTimeoutSec parametresini kullanır. Bu ayar, bu yöneticinin veya diğer yöneticilerin, betiğin çalıştığını doğrulamak ve gerekirse sorun gidermek için oturuma yeniden bağlanmasına izin verir.

Örnek 3 - Birden çok bilgisayarda birden çok PSSessions kullanma

Bu komut serisi, Disconnect-PSSession cmdlet'in kurumsal bir senaryoda nasıl kullanılabileceğini gösterir. Bu durumda, yeni bir teknisyen uzak bilgisayardaki bir oturumda bir komut dosyası başlatır ve bir sorunla karşılaşır. Teknisyen, daha deneyimli bir yöneticinin oturuma bağlanabilmesi ve sorunu çözebilmesi için oturum bağlantısını keser.

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

Teknisyen, birkaç uzak bilgisayarda oturum oluşturarak ve her oturumda bir betik çalıştırarak başlar. İlk komut, üç uzak bilgisayarda New-PSSession oturumu oluşturmak için ITTask cmdlet'ini kullanır. komutu oturumları $s değişkenine kaydeder. İkinci komut, değişkenindeki oturumlarda betik çalıştırmak için Invoke-Command cmdlet'in $s parametresini kullanır.

Srv1 bilgisayarında çalıştırılan betik beklenmeyen hatalar oluşturur. Teknisyen, yöneticisiyle iletişime geçer ve yardım ister. Yönetici, teknisyeni araştırmak için oturum bağlantısını kesmeye yönlendirir. İkinci komut, Srv1 bilgisayarında Get-PSSession oturumunu almak için ITTask cmdlet'ini ve bağlantısını kesmek için Disconnect-PSSession cmdlet'ini kullanır. Bu komut, diğer bilgisayarlardaki ITTask oturumlarını etkilemez.

Üçüncü komut, Get-PSSession oturumlarını almak için ITTask cmdlet'ini kullanır. Çıktı, Srv2 ve Srv30 bilgisayarlarında ITTask oturumlarının bağlantıyı kesme komutundan etkilenmediğini gösterir.

Yönetici, ev bilgisayarında oturum açar, şirket ağına bağlanır, PowerShell'i başlatır ve Srv1 bilgisayarında Get-PSSession oturumunu almak için ITTask cmdlet'ini kullanır. Oturuma erişmek için teknisyenin kimlik bilgilerini kullanır.

Ardından, yönetici Srv1 bilgisayardaki Connect-PSSession oturumuna bağlanmak için ITTask cmdlet'ini kullanır. komutu oturumu $s değişkenine kaydeder.

Yönetici, Invoke-Command değişkenindeki oturumda bazı tanılama komutlarını çalıştırmak için $s cmdlet'ini kullanır. Betiğin gerekli bir dizini bulamadığından başarısız olduğunu algılar. Yönetici dizini oluşturmak için MkDir işlevini kullanır ve ardından Get-PatchStatus.ps1 betiğini yeniden başlatır ve oturum bağlantısını keser. Yönetici, bulguları teknisyene bildirir, görevleri tamamlamak için oturuma yeniden bağlanmasını önerir ve mevcut değilse gerekli dizini oluşturan Get-PatchStatus.ps1 betiğine bir komut eklemesini ister.

Örnek 4 - PSSession için zaman aşımı değerini değiştirme

Bu örnek, oturumun IdleTimeout özelliğinin oturumun bağlantısının kesilebilir hale gelmesi için değerinin nasıl düzeltileceğini göstermektedir.

Bir oturumun boşta kalma zaman aşımı özelliği, bağlantısı kesilmiş bir oturumun silinmeden önce ne kadar süre tutulacaklarını belirlediğinden bağlantısı kesilmiş oturumlar için kritik öneme sahiptir. Oturum oluştururken ve bağlantısını keserken boşta kalma zaman aşımı seçeneğini ayarlayabilirsiniz. Oturumun boşta kalma zaman aşımı için varsayılan değerler yerel bilgisayardaki $PSSessionOption tercih değişkeninde ve uzak bilgisayardaki oturum yapılandırmasında ayarlanır. Oturum için ayarlanan değerler, oturum yapılandırmasında ayarlanan değerlerden önceliklidir, ancak oturum değerleri, MaxIdleTimeoutMs gibi oturum yapılandırmasında ayarlanan kotaları aşamaz.

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

İlk komut, oturum seçeneği nesnesi oluşturmak için New-PSSessionOption cmdlet'ini kullanır. 48 saatlik boşta kalma zaman aşımı ( milisaniye) ayarlamak için 172800000 parametresini kullanır. komutu oturum seçeneği nesnesini $Timeout değişkenine kaydeder.

İkinci komut, Server01 bilgisayarında New-PSSession oturumu oluşturmak için ITTask cmdlet'ini kullanır. komutu oturumu $s değişkenine kaydeder. SessionOption parametresinin değeri, $Timeout değişkenindeki 48 saatlik boşta kalma zaman aşımıdır.

Üçüncü komut, ITTask değişkenindeki $s oturumunun bağlantısını keser. Oturumun boşta kalma zaman aşımı değeri oturum yapılandırmasında MaxIdleTimeoutMs kotasını aştığı için komut başarısız olur. Oturum bağlantısı kesilene kadar boşta kalma zaman aşımı kullanılmadığından, oturum kullanımdayken bu ihlal algılanmayabilir.

Dördüncü komut, Invoke-Command cmdlet'ini kullanarak Server01 bilgisayarında Get-PSSessionConfiguration oturum yapılandırması için bir Microsoft.PowerShell komutu çalıştırır. komut, oturum yapılandırmasının tüm özelliklerini bir listede görüntülemek için Format-List cmdlet'ini kullanır. Çıktı, oturum yapılandırmasını kullanan oturumlar için izin verilen en yüksek IdleTimeout değerini oluşturan MaxIdleTimeoutMs özelliğinin 43200000 milisaniye (12 saat) olduğunu gösterir.

Beşinci komut, $s değişkenindeki oturumun oturum seçeneği değerlerini alır. Birçok oturum seçeneğinin değerleri, oturumun Runspace özelliğinin ConnectionInfo özelliğinin özellikleridir. Çıktı, oturumun IdleTimeout özelliğinin değerinin milisaniye (48 saat) olduğunu ve bu da oturum yapılandırmasında 12 saatlik MaxIdleTimeoutMs kotasını ihlal ettiğini gösterir. Bu çakışmayı çözmek için ConfigurationName parametresini kullanarak farklı bir oturum yapılandırması seçebilir veya oturumun boşta kalma zaman aşımını azaltmak için IdleTimeout parametresini kullanabilirsiniz.

Altıncı komut oturumun bağlantısını keser. Boşta kalma zaman aşımını en fazla 12 saat olarak ayarlamak için IdleTimeoutSec parametresini kullanır.

Yedinci komut, bağlantısı kesilmiş oturumun IdleTimeout özelliğinin değerini alır ve milisaniye cinsinden ölçülür. Çıkış, komutun başarılı olduğunu onaylar.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Id

Belirtilen oturum kimliğine sahip oturumların bağlantısını keser. Bir veya daha fazla kimlik (virgülle ayrılmış) yazın veya bir kimlik aralığı belirtmek için aralık işlecini (..) kullanın.

Oturumun kimliğini almak için Get-PSSession cmdlet'ini kullanın. Örnek kimliği, oturumun Kimliği özelliğinde depolanır.

Parametre özellikleri

Tür:

Int32[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Id
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-IdleTimeoutSec

Bağlantısı kesilmiş PSSession'in boşta kalma zaman aşımı değerini değiştirir. Saniye olarak bir değer girin. Minimum değer 60 (1 dakika) olarak belirtilmiştir.

Bağlantısı kesilmiş PSSession'nin uzak bilgisayarda ne kadar süre tutulacağını boşta kalma zaman aşımı belirler. Zaman aşımı süresi dolduğunda PSSession silinir.

Bağlantısı kesilmiş PSSessions, bağlantı kesilen oturumda komutlar çalıştırılsa bile, bağlantı kesildikleri andan itibaren boşta olarak kabul edilir.

Oturumun boşta kalma zaman aşımı için varsayılan değer, oturum yapılandırmasının IdleTimeoutMs özelliği tarafından ayarlanır. Varsayılan değer 7200000 milisaniyedir (2 saat).

Bu parametrenin değeri, tercih değişkeninin $PSSessionOption özelliğinin değerinden ve oturum yapılandırmasındaki varsayılan boşta kalma zaman aşımı değerinden önceliklidir. Ancak bu değer, oturum yapılandırmasının MaxIdleTimeoutMs özelliğinin değerini aşamaz. MaxIdleTimeoutMs varsayılan değeri 12 saattir ( milisaniye).

Parametre özellikleri

Tür:Int32
Default value:60
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-InstanceId

Belirtilen örnek kimliklerine sahip oturumların bağlantısını koparır.

Oturum Kimliği, yerel veya uzak bir bilgisayardaki oturumu benzersiz şekilde tanımlayan bir GUID'dir. Örnek kimliği, birden çok bilgisayarda birden çok oturumda bile benzersizdir.

Oturumun örnek kimliğini almak için Get-PSSession cmdlet'ini kullanın. Örnek kimliği, oturumun InstanceId özelliğinde depolanır.

Parametre özellikleri

Tür:

Guid[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

InstanceId
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-Name

Belirtilen tanımlayıcı adlarla oturumların bağlantısını keser. Joker karakterlere izin verilir.

Oturumun kolay adını almak için Get-PSSession cmdlet'ini kullanın. Kullanıcı dostu ad, oturumun Adı özelliğinde depolanır.

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

Name
Position:Named
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-OutputBufferingMode

Çıkış arabelleği dolduğunda bağlantı kesilen oturumda komut çıktısının nasıl yönetileceğini belirler. Varsayılan değer şudur: Block.

Bağlantısı kesilmiş oturumdaki komut çıkış döndürecekse ve çıkış arabelleği dolarsa, bu parametrenin değeri, oturumun bağlantısı kesildiğinde komutun çalışmaya devam edip etmeyeceğini etkili bir şekilde belirler. Block değeri, oturum yeniden bağlanana kadar komutu askıya alır. Drop değeri komutun tamamlanmasını sağlar ancak veriler kaybolabilir. Drop değerini kullanırken, komut çıkışını disk üzerindeki bir dosyaya yeniden yönlendirin.

Geçerli değerler şunlardır:

  • Block: Çıkış arabelleği dolduğunda, arabellek temizlenene kadar yürütme askıya alınır.
  • Drop: Çıkış arabelleği dolduğunda yürütme devam eder. Yeni çıkış kaydedildikçe en eski çıkış silinir.
  • None: Hiçbir çıkış arabelleği modu belirtilmedi. Bağlantısı kesilmiş oturum için oturum yapılandırmasının OutputBufferingMode özelliğinin değeri kullanılır.

Parametre özellikleri

Tür:OutputBufferingMode
Default value:Block
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Session

Belirtilen PSSessions'den bağlantıyı keser. PSSession nesnelerini girin, New-PSSession cmdlet'in döndürdüğü nesneler gibi. Ayrıca bir PSSession nesnesini Disconnect-PSSessionöğesine de yöneltebilirsiniz.

Get-PSSession cmdlet'i, uzak bir bilgisayarda sonlanan tüm PSSessions'i alabilir; bunlar arasında bağlantısı kesilmiş PSSessions ve diğer bilgisayarlardaki diğer oturumlara bağlı PSSessions de bulunmaktadır. Disconnect-PSSession yalnızca geçerli oturuma bağlı olan PSSession bağlantılarını keser. Başka PSSession'leri Disconnect-PSSessionile bağlarsanız, Disconnect-PSSession komutu başarısız olur.

Parametre özellikleri

Tür:

PSSession[]

Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Session
Position:1
Zorunlu:True
İşlem hattından gelen değer:True
Özellik adına göre işlem hattından gelen değer:True
Kalan bağımsız değişkenlerden elde edilen değer:False

-ThrottleLimit

Disconnect-PSSession komutu için gaz limitini ayarlar.

Kısıtlama sınırı, bu komutu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısıdır. Bu parametreyi atlarsanız veya 0değerini girerseniz, 32varsayılan değeri kullanılır.

Hız sınırlaması yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.

Parametre özellikleri

Tür:Int32
Default value:32
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

PSSession

Oturumu bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

PSSession

Bu cmdlet, bağlantısının kesildiği oturumu temsil eden bir nesne döndürür.

Notlar

PowerShell, Disconnect-PSSessioniçin aşağıdaki diğer adları içerir:

  • Windows:
    • dnsn

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

  • Disconnect-PSSession cmdlet'i yalnızca yerel ve uzak bilgisayarlar PowerShell 3.0 veya üzerini çalıştırdığında çalışır.

  • bağlantısı kesilmiş bir oturumda Disconnect-PSSession cmdlet'ini kullanırsanız, komutun oturum üzerinde hiçbir etkisi yoktur ve hata oluşturmaz.

  • Etkileşimli güvenlik belirteçleriyle oluşturulan (EnableNetworkAccess parametresi kullanılan) bağlantısı kesilmiş geri döngü oturumları yalnızca oturumun oluşturulduğu bilgisayardan yeniden bağlanabilir. Bu kısıtlama, bilgisayarı kötü amaçlı erişime karşı korur.

  • Bir PSSessionbağlantısını kestiğiniz zaman, oturum durumu Disconnected ve kullanılabilirlik Yok.

    State özelliğinin değeri geçerli oturuma göredir. Bu nedenle Disconnected değeri, PSSession geçerli oturuma bağlı olmadığı anlamına gelir. Ancak bu, PSSession tüm oturumlarla bağlantısının kesildiğini göstermez. Farklı bir oturuma bağlı olabilir. Oturuma bağlanıp bağlanamayacağınızı veya yeniden bağlanabileceğinizi belirlemek için Kullanılabilirlik özelliğini kullanın.

    Kullanılabilirlik değeri None olduğunda oturuma bağlanabileceğinizi gösterir. Busy değeri, başka bir oturuma bağlı olduğundan PSSession bağlanamadığınızı gösterir.

    Oturumların State özelliğinin değerleri hakkında daha fazla bilgi için bkz. RunspaceState Numaralandırması.

    Oturumların Kullanılabilirlik özelliğinin değerleri hakkında daha fazla bilgi için bkz. RunspaceAvailability Sabit Listesi.