Connect-PSSession

Başvuru

Modül:: Microsoft.PowerShell.Core

Bağlantısı kesilmiş oturumlara yeniden bağlanır.

Syntax

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 Availableoturumda 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.

Bağlan ionURI 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 Maximum Bağlan ionRedirectionCount 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 Maximum Bağlan ionRedirectionCount özelliğini ayarlayın. Varsayılan değer şudur: 5.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ı Runspace.Bağlan içinde depolanırOturumun ionInfo.AppName özelliği.

Bu parametrenin değeri oturumları seçmek ve filtrelemek için kullanılır. Oturumun kullandığı uygulamayı değiştirmez.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	AuthenticationMechanism
Accepted values:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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-ChildItemGet-Item komutunu kullanın.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ı, localhostveya bir nokta (.) yazın

Type:	String[]
Aliases:	Cn
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigurationName

Bağlan yalnızca belirtilen oturum yapılandırmasını kullanan oturumlara yöneliktir.

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Uri[]
Aliases:	URI, CU
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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\User01girin. 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?.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Int32[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	Guid[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Bağlantısı kesilmiş oturumların kolay adlarını belirtir.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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ı, 5985HTTP için WinRM bağlantı noktası olan ve 5986HTTPS 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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	PSSession[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	PSSessionOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 0girerseniz varsayılan değer 32olan , kullanılır.

Kısıtlama sınırı yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Girişler

PSSession

Bir oturumu (PSSession) bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

PSSession

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-PSSessioniçerir:

Windows:
- cnsn
Bu cmdlet yalnızca Windows platformlarında kullanılabilir.
Connect-PSSessionyalnı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'unboşta kalma zaman aşımı değerini değiştiremezsiniz. sessionOption parametresiConnect-PSSession, IdleTimeout değerine sahip bir SessionOption nesnesi alır. Ancak, Bir PSSession'a bağlanırken SessionOption nesnesinin IdleTimeoutdeğeri ve değişkenin $PSSessionOption IdleTimeout değeri yoksayılır.

PSSession'u oluştururken, veya Invoke-Command cmdlet'lerini kullanarak New-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.

Connect-PSSession

Syntax

Description

Örnekler

Örnek 1: Oturuma yeniden bağlanma

Örnek 2: Bağlantıyı kesmenin ve yeniden bağlanmanın etkisi

Örnek 3: Kurumsal senaryodaki komut serisi

Parametreler

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-Confirm

-ConnectionUri

-Credential

-Id

-InstanceId

-Name

-Port

-Session

-SessionOption

-ThrottleLimit

-UseSSL

-WhatIf

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Connect-PSSession

Syntax

Description

Örnekler

Örnek 1: Oturuma yeniden bağlanma

Örnek 2: Bağlantıyı kesmenin ve yeniden bağlanmanın etkisi

Örnek 3: Kurumsal senaryodaki komut serisi

Parametreler

-AllowRedirection

-ApplicationName

-Authentication

-CertificateThumbprint

-ComputerName

-ConfigurationName

-Confirm

-ConnectionUri

-Credential

-Id

-InstanceId

-Name

-Port

-Session

-SessionOption

-ThrottleLimit

-UseSSL

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar