Get-PSSession
Yerel ve uzak bilgisayarlardaki PowerShell oturumlarını alır.
Sözdizimi
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]
-InstanceId <Guid[]>
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-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
[-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
[-ConfigurationName <String>]
-InstanceId <Guid[]>
[-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 ConnectionUri 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 ConnectionUri 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-PSSession
Bu 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 Busy
Bu 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 ScheduledJobs
Available
olan 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-PSSession
Bu ö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 $s
Bu ö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-Table
gö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, OperationTimeout 240000
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 None
kullanı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 2
Bu komut KIMLIK 2
ile 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, ConnectionUri 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
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: | All sessions |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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 ConnectionUri 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:
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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | AuthenticationMechanism |
Kabul edilen değerler: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
Position: | Named |
Default value: | Default |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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 ConnectionUri 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-ChildItem
Get-Item
komutunu kullanın.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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ı, localhost
veya 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.
Tür: | String[] |
Diğer adlar: | Cn |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | String |
Position: | Named |
Default value: | All sessions |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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, ConnectionUri 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
.
ConnectionUri belirtmezseniz, ConnectionURI değerlerini belirtmek için UseSSL, ComputerName, Bağlantı Noktası 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.
Tür: | Uri[] |
Diğer adlar: | URI, CU |
Position: | 0 |
Default value: | Http://localhost:5985/WSMAN |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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\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?.
Bu parametre, ComputerName veya ConnectionUri 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.
Tür: | PSCredential |
Position: | Named |
Default value: | Current user |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | Int32[] |
Position: | 0 |
Default value: | All sessions |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | Guid[] |
Position: | Named |
Default value: | All sessions |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | String[] |
Position: | Named |
Default value: | All sessions |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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ı, 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\>
Bu parametre, ComputerName veya ConnectionUri 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.
Tür: | Int32 |
Position: | Named |
Default value: | 5985, 5986 |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
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ğ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.
Tür: | PSSessionOption |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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
, Closed
ve 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.
Tür: | SessionFilterState |
Kabul edilen değerler: | All, Opened, Disconnected, Closed, Broken |
Position: | Named |
Default value: | All |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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 32
olan 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.
Tür: | Int32 |
Position: | Named |
Default value: | 32 |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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.
Tür: | SwitchParameter |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | 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
Tür: | Guid[] |
Diğer adlar: | VMGuid |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | 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.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
Girişler
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
Notlar
Windows PowerShell için aşağıdaki diğer adları Get-PSSession
içerir:
gsn
Bu cmdlet, ,
Enter-PSSession
veInvoke-Command
cmdlet'leri kullanılarakNew-PSSession
oluş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 ConnectionUri parametrelerini kullanın. Gelen oturumları
Get-PSSession
filtrelemek için Name, ID, InstanceID ve State parametrelerini kullanın. Kullanılan geçici oturumuGet-PSSession
yapılandırmak için kalan parametreleri kullanın.ComputerName veya ConnectionUri parametrelerini kullandığınızda,
Get-PSSession
yalnı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