Connect-PSSession
Bağlantısı kesilmiş oturumlara yeniden bağlanır.
Sözdizimi
Connect-PSSession
-Name <String[]>
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-Session] <PSSession[]>
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
-ComputerName <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
-ComputerName <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-ConfigurationName <String>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-ConfigurationName <String>]
[-ConnectionUri] <Uri[]>
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-SessionOption <PSSessionOption>]
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
-InstanceId <Guid[]>
[-ThrottleLimit <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Connect-PSSession
[-ThrottleLimit <Int32>]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Bu cmdlet yalnızca Windows platformunda kullanılabilir.
Cmdlet, Connect-PSSession
bağlantısı kesilmiş kullanıcı tarafından yönetilen PowerShell oturumlarına (PSSessions) yeniden bağlanır. Cmdlet'i veya cmdlet'in InDisconnectedSession parametresini Invoke-Command
kullanmak Disconnect-PSSession
gibi kasıtlı olarak bağlantısı kesilen oturumlarda ve geçici bir ağ kesintisi gibi kasıtsız olarak bağlantısı kesilmiş oturumlarda çalışır.
Connect-PSSession
aynı kullanıcı tarafından başlatılan bağlantısız oturumlara bağlanabilir. Bunlar, tarafından başlatılan veya diğer bilgisayarlardaki diğer oturumlarla bağlantısı kesilenleri içerir.
Ancak, Connect-PSSession
bozuk veya kapalı oturumlara ya da cmdlet'i kullanılarak Enter-PSSession
başlatılan etkileşimli oturumlara bağlanılamaz. Ayrıca, oturumu oluşturan kullanıcının kimlik bilgilerini sağlayamadığınız sürece oturumları diğer kullanıcılar tarafından başlatılan oturumlara bağlayamazsınız.
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: Oturuma yeniden bağlanma
Connect-PSSession -ComputerName Server01 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
4 ITTask Server01 Opened ITTasks Available
Bu komut Server01 bilgisayarındaki oturuma ITTask
yeniden bağlanır.
Çıktı, komutun başarılı olduğunu gösterir. Oturumun Durumu ve Opened
Kullanılabilirlik değeri ise Available
oturumda komut çalıştırabileceğinizi gösterir.
Örnek 2: Bağlantıyı kesmenin ve yeniden bağlanmanın etkisi
Get-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Backups Localhost Opened Microsoft.PowerShell Available
Get-PSSession | Disconnect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Backups Localhost Disconnected Microsoft.PowerShell None
Get-PSSession | Connect-PSSession
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 Backups Localhost Opened Microsoft.PowerShell Available
Bu örnek, bağlantıyı kesmenin ve ardından bir oturuma yeniden bağlanmanın etkisini gösterir.
İlk komut cmdlet'ini Get-PSSession
kullanır. ComputerName parametresi olmadan, komut yalnızca geçerli oturumda oluşturulan oturumları alır.
Çıktı, komutun oturumu yerel bilgisayarda aldığını Backups
gösterir. Oturumun Durumu, Opened
Kullanılabilirlik ise şeklindedirAvailable
.
İkinci komut, geçerli oturumda Get-PSSession
oluşturulan PSSession nesnelerini almak için cmdlet'ini ve Disconnect-PSSession
oturumların bağlantısını kesmek için cmdlet'ini kullanır. Çıktı oturumun bağlantısının Backups
kesildiğini gösterir. Oturumun Durumu, Disconnected
Kullanılabilirlik ise şeklindedirNone
.
Üçüncü komut, geçerli oturumda Get-PSSession
oluşturulan PSSession nesnelerini almak için cmdlet'ini ve Connect-PSSession
oturumları yeniden bağlamak için cmdlet'ini kullanır. Çıktı oturumun Backups
yeniden bağlandığını gösterir. Oturumun Durumu, Opened
Kullanılabilirlik ise şeklindedirAvailable
.
Bağlantısız bir oturumda cmdlet'ini kullanırsanız Connect-PSSession
, komut oturumu etkilemez ve herhangi bir hata oluşturmaz.
Örnek 3: Kurumsal senaryodaki komut serisi
Bu komut serisi, cmdlet'in Connect-PSSession
kurumsal bir senaryoda nasıl kullanılabileceğini gösterir. Bu durumda, sistem yöneticisi uzak bilgisayardaki bir oturumda uzun süre çalışan bir iş başlatır. yönetici işi başlattıktan sonra oturum bağlantısını keser ve eve gider.
Bu akşam yönetici, ev bilgisayarında oturum açar ve işin tamamlanana kadar çalıştığını doğrular.
Yönetici, uzak bir bilgisayarda oturum oluşturarak ve oturumda bir betik çalıştırarak başlar. İlk komut, server01 uzak bilgisayarında oturumu oluşturmak ITTask
için cmdlet'ini kullanırNew-PSSession
. Komut, oturum yapılandırmasını belirtmek için ConfigurationName parametresini ITTasks
kullanır. komutu, oturumları değişkene $s
kaydeder.
değişkenindeki oturumda bir arka plan işi başlatmak için ikinci komut Invoke-Command
cmdlet'i $s
. Arka plan işinde betiği çalıştırmak için FilePath parametresini kullanır.
Üçüncü komut, değişkendeki Disconnect-PSSession
oturum bağlantısını kesmek için cmdlet'ini $s
kullanır. Komut, betiğin oturuma çıkış teslim etmek zorunda kalmadan engellenmesini önlemek için OutputBufferingMode parametresini değeriyle Drop
birlikte kullanır. Oturum zaman aşımı süresini 15 saate uzatmak için IdleTimeoutSec parametresini kullanır. Komut tamamlandığında, yönetici bilgisayarını kilitler ve akşam için eve gider.
Bu akşam yönetici ev bilgisayarını başlatır, şirket ağında oturum açar ve PowerShell'i başlatır. Dördüncü komut, Server01 bilgisayarındaki oturumları almak için cmdlet'ini kullanır Get-PSSession
. Komutu oturumu bulur ITTask
. Beşinci komut, oturuma Connect-PSSession
bağlanmak için cmdlet'ini ITTask
kullanır. komutu, oturumu değişkene $s
kaydeder.
Altıncı komut, değişkenindeki Invoke-Command
oturumda bir Get-Job
komut çalıştırmak için cmdlet'ini $s
kullanır. Çıktı, işin başarıyla tamamlandığını gösterir. Yedinci komut, oturumdaki Invoke-Command
değişkende oturumda $s
bir Receive-Job
komut çalıştırmak için cmdlet'ini kullanır. komutu sonuçları değişkene $BackupSpecs
kaydeder. Sekizinci komut, oturumda Invoke-Command
başka bir betik çalıştırmak için cmdlet'ini kullanır. komutu, betiğin $BackupSpecs
girişi olarak oturumdaki değişkenin değerini kullanır.
$s = New-PSSession -ComputerName Server01 -Name ITTask -ConfigurationName ITTasks
Invoke-Command -Session $s -ScriptBlock {Start-Job -FilePath \\Server30\Scripts\Backup-SQLDatabase.ps1}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
2 Job2 Running True Server01 \\Server30\Scripts\Backup...
Disconnect-PSSession -Session $s -OutputBufferingMode Drop -IdleTimeoutSec 60*60*15
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Disconnected ITTasks None
Get-PSSession -ComputerName Server01 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Disconnected ITTasks None
$s = Connect-PSSession -ComputerName Server01 -Name ITTask
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Opened ITTasks Available
Invoke-Command -Session $s -ScriptBlock {Get-Job}
Id Name State HasMoreData Location Command
-- ---- ----- ----------- -------- -------
2 Job2 Completed True Server01 \\Server30\Scripts\Backup...
Invoke-Command -Session $s -ScriptBlock {$BackupSpecs = Receive-Job -JobName Job2}
Invoke-Command -Session $s -ScriptBlock {\\Server30\Scripts\New-SQLDatabase.ps1 -InitData $BackupSpecs.Initialization}
Disconnect-PSSession -Session $s -OutputBufferingMode Drop -IdleTimeoutSec 60*60*15
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
1 ITTask Server01 Disconnected ITTasks None
Dokuzuncu komut, değişkendeki $s
oturumla bağlantısını keser. Yönetici PowerShell'i kapatır ve bilgisayarı kapatır. Ertesi gün oturuma yeniden bağlanabilir ve iş bilgisayarından betik durumunu kontrol edebilir.
Parametreler
-AllowRedirection
Bu cmdlet'in bu bağlantının alternatif bir URI'ye yeniden yönlendirilmesine izin verdiği gösterir.
ConnectionURI parametresini kullandığınızda, uzak hedef farklı bir URI'ye yönlendirme yönergesi döndürebilir. Varsayılan olarak, PowerShell bağlantıları yeniden yönlendirmez, ancak bağlantıyı yeniden yönlendirmesine izin vermek için bu parametreyi kullanabilirsiniz.
Ayrıca MaximumConnectionRedirectionCount oturum seçeneği değerini değiştirerek bağlantının yeniden yönlendirilme sayısını sınırlayabilirsiniz. Cmdlet'in New-PSSessionOption
MaximumRedirection parametresini kullanın veya $PSSessionOption tercih değişkeninin MaximumConnectionRedirectionCount özelliğini ayarlayın. Varsayılan değer şudur: 5
.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationName
Bir uygulamanın adını belirtir. Bu cmdlet yalnızca belirtilen uygulamayı kullanan oturumlara bağlanır.
Bağlantı URI'sinin uygulama adı kesimini girin. Örneğin, aşağıdaki bağlantı URI'sinde uygulama adı WSMan'dır: http://localhost:5985/WSMAN
. Oturumun uygulama adı, oturumun Runspace.ConnectionInfo.AppName özelliğinde depolanır.
Bu parametrenin değeri oturumları seçmek ve filtrelemek için kullanılır. Oturumun kullandığı uygulamayı değiştirmez.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Authentication
Bağlantısı kesilmiş oturuma yeniden bağlanmak için komuttaki kullanıcı kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
Default
Basic
Credssp
Digest
Kerberos
Negotiate
NegotiateWithImplicitCredential
Varsayılan değer şudur: Default
.
Bu parametrenin değerleri hakkında daha fazla bilgi için bkz . AuthenticationMechanism Numaralandırması.
Dikkat
Kullanıcının kimlik bilgilerinin kimlik doğrulaması için uzak bir bilgisayara geçirildiği Kimlik Bilgisi Güvenlik Destek Sağlayıcısı (CredSSP) kimlik doğrulaması, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, bu bilgisayara geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.
Tür: | AuthenticationMechanism |
Kabul edilen değerler: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-CertificateThumbprint
Bağlantısı kesilmiş oturuma bağlanma izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin.
Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Bunlar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir. Etki alanı hesaplarıyla çalışmazlar.
Sertifika parmak izi almak için PowerShell Cert:
sürücüsünde veya Get-ChildItem
Get-Item
komutunu kullanın.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ComputerName
Bağlantısı kesilmiş oturumların depolandığı bilgisayarları belirtir. Oturumlar, sunucu tarafında veya bağlantının sonundaki bilgisayarda depolanır. Varsayılan, yerel bilgisayardır.
Bir bilgisayarın NetBIOS adını, IP adresini veya tam etki alanı adını yazın. Joker karakterlere izin verilmez. Yerel bilgisayarı belirtmek için bilgisayar adını, localhost
veya bir nokta (.
) yazın
Tür: | String[] |
Diğer adlar: | Cn |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ConfigurationName
Yalnızca belirtilen oturum yapılandırmasını kullanan oturumlara bağlanır.
Oturum yapılandırması için bir yapılandırma adı veya tam kaynak URI'sini girin. Yalnızca yapılandırma adını belirtirseniz, aşağıdaki şema URI'sinin başına eklenir: http://schemas.microsoft.com/powershell
. Oturumun yapılandırma adı, oturumun ConfigurationName özelliğinde depolanır.
Bu parametrenin değeri oturumları seçmek ve filtrelemek için kullanılır. Oturumun kullandığı oturum yapılandırmasını değiştirmez.
Oturum yapılandırmaları hakkında daha fazla bilgi edinmek için bkz. about_Session_Configurations.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ConnectionUri
Bağlantısı kesilmiş oturumlar için bağlantı uç noktalarının URI'lerini belirtir.
URI tam olarak nitelenmiş olmalıdır. Bu dizenin biçimi aşağıdaki gibidir:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Varsayılan değer aşağıdaki gibidir:
http://localhost:5985/WSMAN
Bağlantı URI'sini belirtmezseniz, bağlantı URI'sinin değerlerini belirtmek için UseSSL ve Bağlantı Noktası parametrelerini kullanabilirsiniz.
URI'nin Aktarım kesimi için geçerli değerler HTTP ve HTTPS'dir. Aktarım kesimiyle bir bağlantı URI'sini belirtir, ancak bağlantı noktası belirtmezseniz, oturum standart bağlantı noktalarıyla oluşturulur: 80
HTTP ve 443
HTTPS için. PowerShell uzaktan iletişiminde varsayılan bağlantı noktalarını kullanmak için HTTP veya 5986
HTTPS için bağlantı noktası 5985
belirtin.
Hedef bilgisayar bağlantıyı farklı bir URI'ye yönlendirirse, komutunda AllowRedirection parametresini kullanmadığınız sürece PowerShell yeniden yönlendirmeyi engeller.
Tür: | Uri[] |
Diğer adlar: | URI, CU |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Credential
Bağlantısı kesilmiş oturuma bağlanma izni olan bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.
veya gibi User01
bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential
oluşturulan bir PSCredential nesnesi Domain01\User01
girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureString olarak depolanır.
Not
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
Tür: | PSCredential |
Position: | Named |
Default value: | Current user |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Id
Bağlantısı kesilmiş oturumların kimliklerini belirtir. Id parametresi yalnızca bağlantısı kesilen oturum daha önce geçerli oturuma bağlandığında çalışır.
Oturum yerel bilgisayarda depolandığında ancak geçerli oturuma bağlı olmadığında bu parametre geçerli ancak geçerli değildir.
Tür: | Int32[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-InstanceId
Bağlantısı kesilmiş oturumların örnek kimliklerini belirtir.
Örnek kimliği, yerel veya uzak bir bilgisayarda PSSession'ı benzersiz olarak tanımlayan bir GUID'dir.
Örnek kimliği, PSSession'un InstanceID özelliğinde depolanır.
Tür: | Guid[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Name
Bağlantısı kesilmiş oturumların kolay adlarını belirtir.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Port
Oturuma yeniden bağlanmak için kullanılan uzak bilgisayardaki ağ bağlantı noktasını belirtir. Uzak bilgisayara bağlanmak için, uzak bilgisayar bağlantının kullandığı bağlantı noktasında dinliyor olmalıdır. Varsayılan bağlantı noktaları, 5985
HTTP için WinRM bağlantı noktası olan ve 5986
HTTPS için WinRM bağlantı noktası olan bağlantı noktasıdır.
Alternatif bir bağlantı noktası kullanmadan önce, uzak bilgisayardaki WinRM dinleyicisini bu bağlantı noktasını dinleyecek şekilde yapılandırmanız gerekir. Dinleyiciyi yapılandırmak için PowerShell istemine aşağıdaki iki komutu yazın:
Remove-Item -Path WSMan:\Localhost\listener\listener* -Recurse
New-Item -Path WSMan:\Localhost\listener -Transport http -Address * -Port \<port-number\>
Gerekmedikçe Port parametresini kullanmayın. Komutta ayarlanan bağlantı noktası, komutun çalıştığı tüm bilgisayarlar veya oturumlar için geçerlidir. Alternatif bir bağlantı noktası ayarı, komutun tüm bilgisayarlarda çalışmasını engelleyebilir.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Session
Bağlantısı kesilmiş oturumları belirtir. PSSession nesnelerini içeren bir değişken veya komut gibi PSSession nesnelerini oluşturan veya alan bir Get-PSSession
komut girin.
Tür: | PSSession[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-SessionOption
Oturum için gelişmiş seçenekleri belirtir. Cmdlet'ini kullanarak New-PSSessionOption
oluşturduğunuz bir SessionOption nesnesi veya anahtarların oturum seçeneği adları ve değerlerin oturum seçeneği değerleri olduğu bir karma tablo girin.
Seçenekler için varsayılan değerler, ayarlanmışsa tercih değişkeninin $PSSessionOption
değerine göre belirlenir. Aksi takdirde, varsayılan değerler oturum yapılandırmasında ayarlanan seçenekler tarafından oluşturulur.
Oturum seçeneği değerleri, tercih değişkeninde ve oturum yapılandırmasında $PSSessionOption
ayarlanan oturumlar için varsayılan değerlerden önceliklidir. Ancak, oturum yapılandırmasında ayarlanan maksimum değer, kota veya sınırlardan öncelikli değildir.
Varsayılan değerleri içeren oturum seçeneklerinin açıklaması için bkz New-PSSessionOption
. . $PSSessionOption tercih değişkeni hakkında bilgi için bkz. about_Preference_Variables. Oturum yapılandırmaları hakkında daha fazla bilgi edinmek için bkz. about_Session_Configurations.
Tür: | PSSessionOption |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ThrottleLimit
Bu komutu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir.
Bu parametreyi atlarsanız veya değerini 0
girerseniz varsayılan değer 32
olan , kullanılır.
Kısıtlama sınırı yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-UseSSL
Bu cmdlet'in bağlantısı kesilmiş oturuma bağlanmak için Güvenli Yuva Katmanı (SSL) protokolunu kullandığını gösterir. Varsayılan olarak SSL kullanılmaz.
WS-Management, ağ üzerinden iletilen tüm PowerShell içeriğini şifreler. UseSSL parametresi, verileri HTTP bağlantısı yerine HTTPS bağlantısı üzerinden gönderen ek bir korumadır.
Bu parametreyi kullanıyorsanız, ancak komut için kullanılan bağlantı noktasında SSL kullanılamıyorsa, komut başarısız olur.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Bir oturumu (PSSession) bu cmdlet'e yöneltebilirsiniz.
Çıkışlar
Bu cmdlet, yeniden bağlandığı oturumu temsil eden bir nesne döndürür.
Notlar
PowerShell için aşağıdaki diğer adları Connect-PSSession
içerir:
Windows:
cnsn
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
Connect-PSSession
yalnızca bağlantısı kesilen oturumlara, yani State özelliği için Bağlantısı Kesildi değerine sahip oturumlara yeniden bağlanır. Yalnızca Windows PowerShell 3.0 veya sonraki sürümleri çalıştıran bilgisayarlara bağlı veya sonundaki oturumların bağlantısı kesilebilir ve yeniden bağlanabilir.Bağlantısız bir oturumda kullanıyorsanız
Connect-PSSession
, komut oturumu etkilemez ve hata oluşturmaz.EnableNetworkAccess parametresi kullanılarak oluşturulan etkileşimli belirteçlerle 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.
PsSession'un State özelliğinin değeri geçerli oturuma göredir. Bu nedenle, Bağlantısız değeri PSSession'un geçerli oturuma bağlı olmadığı anlamına gelir. Ancak bu, PSSession'un 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 oturuma yeniden bağlanıp bağlanamayacağınızı belirlemek için Kullanılabilirlik özelliğini kullanın.
Hiçbiri Kullanılabilirlik değeri oturuma bağlanabileceğinizi gösterir. Meşgul değeri, başka bir oturuma bağlı olduğundan PSSession'a 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.
PSSession'a bağlanırken PSSession'un boşta kalma zaman aşımı değerini değiştiremezsiniz. sessionOption parametresi
Connect-PSSession
, IdleTimeout değerine sahip bir SessionOption nesnesi alır. Ancak, Bir PSSession'a bağlanırken SessionOption nesnesinin IdleTimeout değeri ve değişkenin$PSSessionOption
IdleTimeout değeri yoksayılır.PSSession'u oluştururken, veya
Invoke-Command
cmdlet'lerini kullanarakNew-PSSession
ve PSSession bağlantısını kestiğiniz zaman PSSession'un boşta kalma süresini ayarlayabilir ve değiştirebilirsiniz.Bir PSSession'un IdleTimeout özelliği, bağlantısı kesilmiş bir oturumun uzak bilgisayarda ne kadar süre tutulacaklarını belirlediğinden bağlantısı kesilmiş oturumlar için kritik öneme sahiptir. Bağlantısı kesilmiş oturumlarda komutlar çalıştırılsa bile bağlantısı kesilen oturumların bağlantısı kesildiğinde boşta olduğu kabul edilir.
İlişkili Bağlantılar
PowerShell