Connect-PSSession

Modül:
Microsoft.PowerShell.Core Module

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

Syntax

Name (Varsayılan) 

Connect-PSSession
    -Name <String[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Session 

Connect-PSSession
    [-Session] <PSSession[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerNameGuid 

Connect-PSSession
    -ComputerName <String[]>
    -InstanceId <Guid[]>
    [-ApplicationName <String>]
    [-ConfigurationName <String>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-Port <Int32>]
    [-UseSSL]
    [-SessionOption <PSSessionOption>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ComputerName 

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>]

ConnectionUriGuid 

Connect-PSSession
    [-ConnectionUri] <Uri[]>
    -InstanceId <Guid[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-SessionOption <PSSessionOption>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ConnectionUri 

Connect-PSSession
    [-ConnectionUri] <Uri[]>
    [-ConfigurationName <String>]
    [-AllowRedirection]
    [-Name <String[]>]
    [-Credential <PSCredential>]
    [-Authentication <AuthenticationMechanism>]
    [-CertificateThumbprint <String>]
    [-SessionOption <PSSessionOption>]
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InstanceId 

Connect-PSSession
    -InstanceId <Guid[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id 

Connect-PSSession
    [-Id] <Int32[]>
    [-ThrottleLimit <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Connect-PSSession cmdlet'i, bağlantısı kesilmiş olan kullanıcı tarafından yönetilen PowerShell oturumlarına (PSSessions) yeniden bağlanır. Disconnect-PSSession cmdlet'inin cmdlet'ini veya Invoke-Command parametresini kullanarak 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ı kesilmiş herhangi bir oturuma 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 Enter-PSSession cmdlet'i kullanılarak başlatılan etkileşimli oturumlara bağlanamaz. 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 ITTask oturumuna yeniden bağlanır.

Çıktı, komutun başarılı olduğunu gösterir. Oturumun DurumuOpened ve KullanılabilirlikAvailable, 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 Get-PSSession cmdlet'ini kullanır. ComputerName parametresi olmadan, komut yalnızca geçerli oturumda oluşturulan oturumları alır.

Çıktı, komutun yerel bilgisayarda Backups oturumunu aldığını gösterir. Oturumun DurumuOpened ve KullanılabilirlikAvailable.

İkinci komut, geçerli oturumda oluşturulan Get-PSSession nesnelerini almak için cmdlet'ini ve oturumların bağlantısını kesmek için Disconnect-PSSession cmdlet'ini kullanır. Çıktı, Backups oturumunun bağlantısının kesildiğini gösterir. Oturumun DurumuDisconnected ve KullanılabilirlikNone.

Üçüncü komut, geçerli oturumda oluşturulan Get-PSSession nesnelerini almak için cmdlet'ini ve oturumları yeniden bağlamak için Connect-PSSession cmdlet'ini kullanır. Çıktı, Backups oturumunun yeniden bağlandığını gösterir. Oturumun DurumuOpened ve KullanılabilirlikAvailable.

bağlantısız bir oturumda Connect-PSSession cmdlet'ini kullanırsanız, komut oturumu etkilemez ve herhangi bir hata oluşturmaz.

Örnek 3: Kurumsal senaryodaki komut serisi

Bu komut serisi, Connect-PSSession cmdlet'in 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 New-PSSession oturumu oluşturmak için ITTask cmdlet'ini kullanır. komut, oturum yapılandırmasını belirtmek için ITTasks parametresini kullanır. komutu oturumları $s değişkenine kaydeder.

İkinci komut, Invoke-Command değişkenindeki oturumda bir arka plan işi başlatmak için cmdlet'ini $s. Betiği arka plan işinde çalıştırmak için FilePath parametresini kullanır.

Üçüncü komut, Disconnect-PSSession değişkenindeki oturum bağlantısını kesmek için $s cmdlet'ini kullanır. Komut OutputBufferingMode parametresini Drop değeriyle kullanarak betiğin oturuma çıkış teslim etmek zorunda kalmadan engellenmesini önler. 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 Get-PSSession cmdlet'ini kullanır. Komut ITTask oturumunu bulur. Beşinci komut, Connect-PSSession oturumuna bağlanmak için ITTask cmdlet'ini kullanır. komutu oturumu $s değişkenine kaydeder.

Altıncı komut, Invoke-Command değişkenindeki oturumda bir Get-Job komutu çalıştırmak için $s cmdlet'ini kullanır. Çıktı, işin başarıyla tamamlandığını gösterir. Yedinci komut, Invoke-Command cmdlet'ini kullanarak oturumdaki Receive-Job değişkenindeki oturumda bir $s komutu çalıştırır. komutu sonuçları $BackupSpecs değişkenine kaydeder. Sekizinci komut, oturumda başka bir betik çalıştırmak için Invoke-Command cmdlet'ini kullanır. komut, betiğin girişi olarak oturumdaki $BackupSpecs değişkeninin 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, $s değişkenindeki 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 parametresini kullanın veya $PSSessionOption tercih değişkeninin MaximumConnectionRedirectionCount özelliğini ayarlayın. Varsayılan değer şudur: 5.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ConnectionUriGuid
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
ConnectionUri
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

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
Position:Named
Zorunlu:False
İş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
ComputerName
Position:Named
Zorunlu:False
İş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

-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 parametre için kabul edilebilir değerler ş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. Kimlik Doğrulama Mekanizması Enumerasyonu.

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.

Parametre özellikleri

Tür:AuthenticationMechanism
Default value:None
Kabul edilen değerler:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
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
ComputerName
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
ConnectionUriGuid
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
ConnectionUri
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

-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 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 Get-Item sürücüsünde bir Get-ChildItem veya Cert: komutu kullanın.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
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
ComputerName
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
ConnectionUriGuid
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
ConnectionUri
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

-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 değer 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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cn

Parametre kümeleri

ComputerNameGuid
Position:Named
Zorunlu:True
İş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
ComputerName
Position:Named
Zorunlu:True
İş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

-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 için bkz. about_Session_Configurations.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
Position:Named
Zorunlu:False
İş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
ComputerName
Position:Named
Zorunlu:False
İş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
ConnectionUriGuid
Position:Named
Zorunlu:False
İş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
ConnectionUri
Position:Named
Zorunlu:False
İş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

-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

-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 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 bağlantı URI'sini belirtirseniz ancak bağlantı noktası belirtmezseniz, oturum standart bağlantı noktalarıyla oluşturulur: HTTP için 80 ve HTTPS için 443. PowerShell uzaktan iletişiminde varsayılan bağlantı noktalarını kullanmak için HTTP için bağlantı noktası 5985 veya HTTPS için 5986 belirtin.

Hedef bilgisayar bağlantıyı farklı bir URI'ye yönlendirirse, komutta AllowRedirection parametresini kullanmadığınız sürece PowerShell yeniden yönlendirmeyi engeller.

Parametre özellikleri

Tür:

Uri[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:URI (Evrensel Kaynak Tanımlayıcısı), CU

Parametre kümeleri

ConnectionUriGuid
Position:0
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
ConnectionUri
Position:0
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

-Credential

Bağlantısı kesilmiş oturuma bağlanma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.

User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız parolayı girmeniz istenir.

Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.

Uyarı

SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.

Parametre özellikleri

Tür:PSCredential
Default value:Current user
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
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
ComputerName
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
ConnectionUriGuid
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
ConnectionUri
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

Bağlantısı kesilmiş oturumların kimliklerini belirtir. Kimliği 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.

Parametre özellikleri

Tür:

Int32[]

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

Parametre kümeleri

Id
Position:0
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

-InstanceId

Bağlantısı kesilmiş oturumların örnek kimliklerini belirtir.

Örnek Tanımlayıcı, yerel veya uzak bir bilgisayardaki PSSession'i benzersiz olarak tanımlayan bir GUID'dir.

Örnek kimliği, PSSessionInstanceID özelliğinde depolanır.

Parametre özellikleri

Tür:

Guid[]

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

Parametre kümeleri

ComputerNameGuid
Position:Named
Zorunlu:True
İş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
ConnectionUriGuid
Position:Named
Zorunlu:True
İş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
Position:Named
Zorunlu:True
İş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

-Name

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
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:False
Kalan bağımsız değişkenlerden elde edilen değer:False
ComputerName
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
ConnectionUri
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

-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ın, bağlantının kullanıldığı bağlantı noktasını dinliyor olması gerekir. Varsayılan bağlantı noktaları, HTTP için WinRM bağlantı noktası olan 5985ve HTTPS için WinRM bağlantı noktası olan 5986'dir.

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\>

Bağlantı Noktası parametresini gerekmedikçe 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.

Parametre özellikleri

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

Parametre kümeleri

ComputerNameGuid
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
ComputerName
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

Bağlantısı kesilmiş oturumları belirtir. PSSession nesnelerini içeren bir değişken veya komutu gibi Get-PSSession nesnelerini oluşturan veya alan bir komut girin.

Parametre özellikleri

Tür:

PSSession[]

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

Parametre kümeleri

Session
Position:0
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

-SessionOption

Oturum için gelişmiş seçenekleri belirtir. cmdlet'ini kullanarak oluşturduğunuz bir nesne veya anahtarların oturum seçeneği adları ve değerlerin oturum seçeneği değerleri olduğu karma tablo gibi bir New-PSSessionOption nesnesi girin.

Seçenekler için varsayılan değerler, ayarlanmışsa $PSSessionOption tercih değişkeninin 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, $PSSessionOption tercih değişkeninde ve oturum yapılandırmasında 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 için bkz. about_Session_Configurations.

Parametre özellikleri

Tür:PSSessionOption
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
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
ComputerName
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
ConnectionUriGuid
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
ConnectionUri
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

-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 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:None
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

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ComputerNameGuid
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
ComputerName
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 ( 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, Connect-PSSessioniçin aşağıdaki diğer adları içerir:

  • Windows:

    • cnsn

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

  • Connect-PSSession yalnızca bağlantısı kesilmiş oturumlara, yani Durumu ö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 Connect-PSSession kullanırsanız, 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.

  • PSSessionState özelliğinin değeri geçerli oturuma göredir. Bu nedenle, Bağlantısı Kesilmiş 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 "Yok" olduğunda oturuma bağlanabileceğinizi gösterir. Meşgul 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.

  • PSSessionbağlanırken PSSession boşta kalma zaman aşımı değerini değiştiremezsiniz. Connect-PSSession parametresi, IdleTimeout değerine sahip bir SessionOption nesnesi alır. Ancak, SessionOption nesnesinin IdleTimeout değeri ve değişkeninin $PSSessionOption değeri, PSSessionbağlanırken yoksayılır.

    PSSessionoluşturduğunuzda, veya New-PSSession cmdlet'lerini kullanarak ve Invoke-Commandbağlantısını kestiğiniz zaman PSSession boşta kalma süresini ayarlayabilir ve değiştirebilirsiniz.

    Bir PSSessionIdleTimeout ö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 önem taşır. 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.