Get-PSSession
Yerel ve uzak bilgisayarlardaki PowerShell oturumlarını alır.
Syntax
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ComputerName] <String[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-ContainerId <String[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-State <SessionFilterState>]
-VMId <Guid[]>
[<CommonParameters>]Get-PSSession
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
-VMName <String[]>
[<CommonParameters>]Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]Description
Cmdlet, Get-PSSession yerel ve uzak bilgisayarlarda kullanıcı tarafından yönetilen PowerShell oturumlarını (PSSessions) alır.
Windows PowerShell 3.0'dan başlayarak, oturumlar her bağlantının uzak ucundaki bilgisayarlarda depolanır. Geçerli oturumda oluşturulmamış olsalar Get-PSSession bile yerel bilgisayara veya uzak bilgisayarlara bağlanan oturumları almak için ComputerName veya Bağlan ionUri parametrelerini kullanabilirsiniz.
Parametreler olmadan, Get-PSSession geçerli oturumda oluşturulan tüm oturumları alır.
Dönen oturumlar Get-PSSession arasından seçim yapmak için Name, ID, InstanceID, State, ApplicationName ve ConfigurationName gibi filtreleme parametrelerini kullanın.
ComputerName veya Bağlan ionUri parametrelerini kullandığınızda komutun Get-PSSession çalıştırıldığı geçici bağlantıyı yapılandırmak için kalan parametreleri kullanın.
Not
Windows PowerShell 2.0'da parametreler olmadan geçerli Get-PSSession oturumda oluşturulan tüm oturumları alır. ComputerName parametresi geçerli oturumda oluşturulan oturumları alır ve belirtilen bilgisayara bağlanır.
PowerShell oturumları hakkında daha fazla bilgi için bkz . about_PSSessions.
Örnekler
Örnek 1: Geçerli oturumda oluşturulan oturumları alma
Get-PSSessionBu komut, geçerli oturumda oluşturulan tüm PSSessions'ı alır. Bu bilgisayara bağlansalar bile diğer oturumlarda veya diğer bilgisayarlarda oluşturulan PSSessions'ı almaz.
Örnek 2: Yerel bilgisayara bağlı oturumları alma
Get-PSSession -ComputerName "localhost"Bu komut, yerel bilgisayara bağlı PSSessions alır. Yerel bilgisayarı belirtmek için bilgisayar adını, localhost'ı veya bir nokta (.) yazın
Komut, farklı oturumlarda veya farklı bilgisayarlarda oluşturulmuş olsalar bile yerel bilgisayardaki tüm oturumları döndürür.
Örnek 3: Bilgisayara bağlı oturumları alma
Get-PSSession -ComputerName "Server02"
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
2 Session3 Server02 Disconnected ITTasks Busy
1 ScheduledJobs Server02 Opened Microsoft.PowerShell Available
3 Test Server02 Disconnected Microsoft.PowerShell BusyBu komut, Server02 bilgisayarına bağlı PSSessions'ı alır.
Komut, farklı oturumlarda veya farklı bilgisayarlarda oluşturulmuş olsalar bile Server02'deki tüm oturumları döndürür.
Çıktı, iki oturumun Disconnected durumunun ve Busy kullanılabilirliğinin olduğunu gösterir.
Bunlar farklı oturumlarda oluşturulmuştur ve şu anda kullanımdadır. ve ScheduledJobsAvailableolan Opened oturum, geçerli oturumda oluşturulmuştur.
Örnek 4: Bu komutun sonuçlarını kaydedin
New-PSSession -ComputerName Server01, Server02, Server03
$s1, $s2, $s3 = Get-PSSessionBu örnekte, bir Get-PSSession komutun sonuçlarının birden çok değişkene nasıl kaydedilecekleri gösterilmektedir.
İlk komut, üç uzak bilgisayarda PSSessions oluşturmak için cmdlet'ini kullanırNew-PSSession.
İkinci komut üç PSSessions almak için bir Get-PSSession cmdlet kullanır. Ardından PSSessions'ın her birini ayrı bir değişkene kaydeder.
PowerShell bir dizi nesneyi bir değişken dizisine atadığında, ilk nesneyi ilk değişkene, ikinci nesneyi ikinci değişkene atar ve bu şekilde devam eder. Değişkenlerden daha fazla nesne varsa, kalan tüm nesneleri dizideki son değişkene atar. Nesnelerden daha fazla değişken varsa, ek değişkenler kullanılmaz.
Örnek 5: Örnek kimliği kullanarak oturumu silme
Get-PSSession | Format-Table -Property ComputerName, InstanceID
$s = Get-PSSession -InstanceID a786be29-a6bb-40da-80fb-782c67f7db0f
Remove-PSSession -Session $sBu örnekte, örnek kimliğini kullanarak PSSession'un nasıl alındığı ve ardından PSSession'un nasıl silineceği gösterilmektedir.
İlk komut, geçerli oturumda oluşturulan tüm PSSessions'ı alır. HER PSSession'un ComputerName ve InstanceID özelliklerini görüntüleyen cmdlet'ine PSSessions Format-Tablegönderir.
İkinci komut, belirli bir PSSession'ı almak ve değişkene kaydetmek için cmdlet'ini $s kullanırGet-PSSession. komut, PSSession'ı tanımlamak için InstanceID parametresini kullanır.
Üçüncü komut, değişkendeki PSSession'ı silmek için Remove-PSSession cmdlet'ini$s kullanır.
Örnek 6: Belirli bir ada sahip bir oturum alma
Bu örnekteki komutlar, belirli bir ad biçimine sahip olan ve belirli bir oturum yapılandırmasını kullanan bir oturumu bulur ve ardından oturuma bağlanır. Bir iş arkadaşınızın görevi başlattığı bir oturumu bulmak ve görevi tamamlamak için bağlanmak için bunun gibi bir komut kullanabilirsiniz.
Get-PSSession -ComputerName Server02, Server12 -Name BackupJob* -ConfigurationName ITTasks -SessionOption @{OperationTimeout=240000}
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
3 BackupJob04 Server02 Disconnected ITTasks None
$s = Get-PSSession -ComputerName Server02 -Name BackupJob04 -ConfigurationName ITTasks | Connect-PSSession
$s
Id Name ComputerName State ConfigurationName Availability
-- ---- ------------ ----- ----------------- ------------
5 BackupJob04 Server02 Opened ITTasks Availableİlk komut, Sunucu02 ve Server12 uzak bilgisayarlarında oturumları alır ve oturum yapılandırmasını kullanan ITTasks adlara BackupJob sahiptir. Komut, ad desenini belirtmek için Name parametresini ve oturum yapılandırmasını belirtmek için ConfigurationName parametresini kullanır. SessionOption parametresinin değeri, OperationTimeout240000 değerini milisaniye (4 dakika) olarak ayarlayan bir karma tablodur. Bu ayar komutun tamamlanması için daha fazla zaman verir. ConfigurationName ve SessionOption parametreleri, cmdlet'in Get-PSSession her bilgisayarda çalıştığı geçici oturumları yapılandırmak için kullanılır. Çıktı, komutun oturumu döndürdüğünü BackupJob04 gösterir. Oturumun bağlantısı kesilir ve Kullanılabilirlik değeri Nonekullanımda olmadığını gösterir.
İkinci komut, oturuma ulaşmak için cmdlet'ini BackupJob04 ve Connect-PSSession oturuma bağlanmak için cmdlet'ini kullanırGet-PSSession. komutu, oturumu değişkene $s kaydeder.
Üçüncü komut, değişkenindeki $s oturumu alır. Çıktı, komutun Connect-PSSession başarılı olduğunu gösterir. Oturum Açıldı durumundadır ve kullanılabilir.
Örnek 7: Kimliğini kullanarak oturum alma
Get-PSSession -Id 2Bu komut KIMLIK 2ile PSSession alır. Id özelliğinin değeri yalnızca geçerli oturumda benzersiz olduğundan, Id parametresi yalnızca yerel komutlar için geçerlidir.
Parametreler
-AllowRedirection
Bu cmdlet'in bu bağlantının alternatif bir Tekdüzen Kaynak Tanımlayıcısı'na (URI) yeniden yönlendirilmesine izin verdiği gösterir. Varsayılan olarak, PowerShell bağlantıları yeniden yönlendirmez.
Bu parametre, Bağlan ionUri parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıyı yapılandırıyor.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 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: | All sessions |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Authentication
Komutun çalıştığı oturum için kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı Get-PSSession belirtir.
Bu parametre, ComputerName veya Bağlan ionUri parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıyı yapılandırıyor.
Bu parametrenin kabul edilebilir değerleri şunlardır:
DefaultBasicCredSSPDigestKerberosNegotiateNegotiateWithImplicitCredential.
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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | AuthenticationMechanism |
| Accepted values: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Default value: | Default |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificateThumbprint
Komutun çalıştığı oturumu oluşturma izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını Get-PSSession (X509) belirtir. Sertifikanın sertifika parmak izini girin.
Bu parametre, ComputerName veya Bağlan ionUri parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıyı yapılandırıyor.
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ışmaz.
Sertifika parmak izi almak için PowerShell Cert: sürücüsünde veya Get-ChildItemGet-Item komutunu kullanın.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
Bilgisayar adlarının bir dizisini belirtir. Belirtilen bilgisayarlara bağlanan oturumları alır. Joker karakterlere izin verilmez. Varsayılan değer yoktur.
Windows PowerShell 3.0'da başlayarak, PSSession nesneleri her bağlantının uzak ucundaki bilgisayarlarda depolanır. Oturumları belirtilen bilgisayarlarda almak için PowerShell her bilgisayara geçici bir bağlantı oluşturur ve bir Get-PSSession komut çalıştırır.
Bir veya daha fazla bilgisayarın NetBIOS adını, IP adresini veya tam etki alanı adını yazın. Yerel bilgisayarı belirtmek için bilgisayar adını, localhostveya bir nokta (. ) yazın.
Not
Bu parametre oturumları yalnızca PowerShell'in Windows PowerShell 3.0 veya sonraki sürümlerini çalıştıran bilgisayarlardan alır. Önceki sürümler oturumları depolamaz.
| Type: | String[] |
| Aliases: | Cn |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConfigurationName
Yapılandırmanın adını belirtir. Bu cmdlet yalnızca belirtilen oturum yapılandırmasını kullanan oturumlara alı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.
| Type: | String |
| Position: | Named |
| Default value: | All sessions |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ConnectionUri
Komutun çalıştığı geçici oturum Get-PSSession için bağlantı uç noktasını tanımlayan bir URI belirtir. URI tam olarak nitelenmiş olmalıdır.
Bu parametre, Bağlan ionUri parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıyı yapılandırıyor.
Bu dizenin biçimi:
<Transport>://<ComputerName>:<Port\>/<ApplicationName>
Varsayılan değer: http://localhost:5985/WSMAN.
Bağlan ionUri belirtmezseniz, Bağlan ionURI değerlerini belirtmek için UseSSL, ComputerName, Port ve ApplicationName 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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Bu parametre oturumları yalnızca Windows PowerShell 3.0 veya sonraki Windows PowerShell sürümlerini çalıştıran bilgisayarlardan alır. Önceki sürümler oturumları depolamaz.
| Type: | Uri[] |
| Aliases: | URI, CU |
| Position: | 0 |
| Default value: | Http://localhost:5985/WSMAN |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ContainerId
Kapsayıcıların kimlik dizisini belirtir. Bu cmdlet, belirtilen kapsayıcıların her biriyle etkileşimli bir oturum başlatır. docker ps Kapsayıcı kimliklerinin listesini almak için komutunu kullanın. Daha fazla bilgi için docker ps komutunun yardımına bakın.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Credential
Kullanıcı kimlik bilgilerini belirtir. Bu cmdlet, belirtilen kullanıcının izinleriyle komutunu çalıştırır. Uzak bilgisayara bağlanma ve bir komut çalıştırma izni olan bir Get-PSSession kullanıcı hesabı belirtin. 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?.
Bu parametre, ComputerName veya Bağlan ionUri parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıya yapılandırılır.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Bir oturum kimlikleri dizisi belirtir. Bu cmdlet yalnızca belirtilen kimliklere sahip oturumları alır. Virgülle ayırarak bir veya daha fazla kimlik yazın veya aralık işlecini (..) kullanarak bir kimlik aralığı belirtin.
Id parametresini ComputerName parametresiyle birlikte kullanamazsınız.
Kimlik, geçerli oturumdaki kullanıcı tarafından yönetilen oturumları benzersiz olarak tanımlayan bir tamsayıdır. Hatırlamak ve yazmak InstanceId değerinden daha kolaydır, ancak yalnızca geçerli oturum içinde benzersizdir. Oturumun kimliği, oturumun ID özelliğinde depolanır.
| Type: | Int32[] |
| Position: | 0 |
| Default value: | All sessions |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InstanceId
Oturumların örnek kimliklerinden oluşan bir dizi belirtir. Bu cmdlet yalnızca belirtilen örnek kimliklerine sahip oturumları alır.
Örnek kimliği, yerel veya uzak bilgisayardaki oturumu benzersiz olarak tanımlayan bir GUID'dir. PowerShell'de çalışan birden çok oturuma sahip olsanız bile InstanceID benzersizdir.
Oturumun örnek kimliği, oturumun InstanceID özelliğinde depolanır.
| Type: | Guid[] |
| Position: | Named |
| Default value: | All sessions |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Oturum adları dizisini belirtir. Bu cmdlet yalnızca belirtilen kolay adlara sahip oturumları alır. Joker karakterlere izin verilir.
Oturumun kolay adı, oturumun Name özelliğinde depolanır.
| Type: | String[] |
| Position: | Named |
| Default value: | All sessions |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Port
Komutun çalıştığı geçici bağlantı Get-PSSession için kullanılan belirtilen 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\>
Bu parametre, ComputerName veya Bağlan ionUri parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıya yapılandırılır.
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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | Int32 |
| Position: | Named |
| Default value: | 5985, 5986 |
| Required: | False |
| Accept pipeline input: | False |
| 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ğerler de dahil olmak üzere oturum seçeneklerinin açıklaması için bkz New-PSSessionOption. .
Tercih değişkeni hakkında $PSSessionOption 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 |
-State
Oturum durumunu belirtir. Bu cmdlet yalnızca belirtilen durumdaki oturumları alır. Bu parametre için kabul edilebilir değerler şunlardır: All, Opened, Disconnected, Closedve Broken. Varsayılan değer şudur: All.
Oturum durumu değeri geçerli oturumlara göredir. Geçerli oturumlarda oluşturulmamış ve geçerli oturuma bağlı olmayan oturumların durumu Disconnected , farklı bir oturuma bağlı olsalar bile geçerlidir.
Oturumun durumu, oturumun State özelliğinde depolanır.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | SessionFilterState |
| Accepted values: | All, Opened, Disconnected, Closed, Broken |
| Position: | Named |
| Default value: | All |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ThrottleLimit
Komutu çalıştırmak Get-PSSession için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir. Bu parametreyi atlar veya (sıfır) değerini 0 girerseniz, 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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | Int32 |
| Position: | Named |
| Default value: | 32 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseSSL
Bu cmdlet'in, komutun çalıştırıldığı bağlantıyı kurmak için Güvenli Yuva Katmanı (SSL) protokolunu Get-PSSession kullandığını gösterir. Varsayılan olarak SSL kullanılmaz. 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.
Bu parametre, ComputerName parametresiyle bir Get-PSSession komut çalıştırmak için oluşturulan geçici bağlantıyı yapılandırıyor.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMId
Sanal makinelerin kimlik dizisini belirtir. Bu cmdlet, belirtilen sanal makinelerin her biriyle etkileşimli bir oturum başlatır. Kullanabileceğiniz sanal makineleri görmek için aşağıdaki komutu kullanın:
Get-VM | Select-Object -Property Name, ID
| Type: | Guid[] |
| Aliases: | VMGuid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMName
Sanal makinelerin ad dizisini belirtir. Bu cmdlet, belirtilen sanal makinelerin her biriyle etkileşimli bir oturum başlatır. Kullanabileceğiniz sanal makineleri görmek için cmdlet'ini Get-VM kullanın.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
Notlar
PowerShell için aşağıdaki diğer adları Get-PSSessioniçerir:
Tüm platformlar:
gsn
Bu cmdlet, ,
Enter-PSSessionveInvoke-Commandcmdlet'leri kullanılarakNew-PSSessionoluşturulanlar gibi kullanıcı tarafından yönetilen oturumlar PSSession nesnelerini" alır. PowerShell'i başlattığınızda oluşturulan sistem tarafından yönetilen oturumu almaz.Windows PowerShell 3.0'dan başlayarak, PSSession nesneleri sunucu tarafında veya bağlantının sonundaki bilgisayarda depolanır. Yerel bilgisayarda veya uzak bilgisayarda depolanan oturumları almak için PowerShell, belirtilen bilgisayarda geçici bir oturum oluşturur ve oturumda sorgu komutlarını çalıştırır.
Uzak bilgisayara bağlanan oturumları almak için, uzak bilgisayarı belirtmek için ComputerName veya Bağlan ionUri parametrelerini kullanın. Gelen oturumları
Get-PSSessionfiltrelemek için Name, ID, InstanceID ve State parametrelerini kullanın. Kullanılan geçici oturumuGet-PSSessionyapılandırmak için kalan parametreleri kullanın.ComputerName veya Bağlan ionUri parametrelerini kullandığınızda,
Get-PSSessionyalnızca PowerShell'in Windows PowerShell 3.0 ve sonraki sürümlerini çalıştıran bilgisayarlardan oturumları alır.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. Geçerli oturumdan PSSession'a bağlanıp bağlanamayacağınızı veya yeniden bağlanabileceğinizi 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.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin