Get-PSSession
Yerel ve uzak bilgisayarlardaki PowerShell oturumlarını alır.
Syntax
Name (Varsayılan)
Get-PSSession
[-Name <String[]>]
[<CommonParameters>]
ComputerName
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>]
ComputerInstanceId
Get-PSSession
[-ComputerName] <String[]>
-InstanceId <Guid[]>
[-ApplicationName <String>]
[-ConfigurationName <String>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-Port <Int32>]
[-UseSSL]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUri
Get-PSSession
[-ConnectionUri] <Uri[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Name <String[]>]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
ConnectionUriInstanceId
Get-PSSession
[-ConnectionUri] <Uri[]>
-InstanceId <Guid[]>
[-ConfigurationName <String>]
[-AllowRedirection]
[-Credential <PSCredential>]
[-Authentication <AuthenticationMechanism>]
[-CertificateThumbprint <String>]
[-ThrottleLimit <Int32>]
[-State <SessionFilterState>]
[-SessionOption <PSSessionOption>]
[<CommonParameters>]
VMNameInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMName <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerId
Get-PSSession
-ContainerId <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
ContainerIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-ContainerId <String[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMId
Get-PSSession
-VMId <Guid[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMIdInstanceId
Get-PSSession
-InstanceId <Guid[]>
-VMId <Guid[]>
[-ConfigurationName <String>]
[-State <SessionFilterState>]
[<CommonParameters>]
VMName
Get-PSSession
-VMName <String[]>
[-ConfigurationName <String>]
[-Name <String[]>]
[-State <SessionFilterState>]
[<CommonParameters>]
InstanceId
Get-PSSession
[-InstanceId <Guid[]>]
[<CommonParameters>]
Id
Get-PSSession
[-Id] <Int32[]>
[<CommonParameters>]
Description
Get-PSSession cmdlet'i, 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 bile yerel bilgisayara veya uzak bilgisayarlara bağlanan oturumları almak için ComputerName veya Get-PSSession parametrelerini kullanabilirsiniz.
Parametreler olmadan, Get-PSSession geçerli oturumda oluşturulan tüm oturumları alır.
Name, Id, InstanceId, State, ApplicationNameve ConfigurationName gibi filtreleme parametrelerini kullanarak Get-PSSession döndüren oturumlar arasından seçim yapın.
Get-PSSession veya ConnectionUri parametrelerini kullandığınızda komutunun çalıştırıldığı geçici bağlantıyı yapılandırmak için kalan parametreleri kullanın.
Uyarı
Windows PowerShell 2.0'da, parametreler olmadan Get-PSSession geçerli 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 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 durumuna ve Busy kullanılabilirliğine sahip olduğunu gösterir.
Bunlar farklı oturumlarda oluşturulmuştur ve şu anda kullanımdadır.
ScheduledJobs ve Openedolan Available oturumu 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 komutunun sonuçlarının birden çok değişkene nasıl kaydedilecekleri gösterilmektedir.
İlk komut, üç uzak bilgisayarda New-PSSession oluşturmak için cmdlet'ini kullanır.
İkinci komut, üç Get-PSSessionalmak için cmdlet'ini kullanır. Ardından PSSessions 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 bir PSSession alma ve ardından PSSessionsilme işlemi gösterilmektedir.
İlk komut, geçerli oturumda oluşturulan tüm PSSessions alır.
PSSessionsFormat-Table cmdlet'ine gönderir. Bu cmdlet, her PSSessionComputerName ve InstanceId özelliklerini görüntüler.
İkinci komut, belirli bir Get-PSSession almak ve değişkenine kaydetmek için $s cmdlet'ini kullanır. komut, PSSessiontanımlamak için InstanceId parametresini kullanır.
Üçüncü komut, değişkenindeki $s silmek için Remove-PSSession cmdlet'ini 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, BackupJob ile başlayan ve ITTasks oturum yapılandırmasını kullanan adları olan Server02 ve Server12 uzak bilgisayarlarında oturumları alır. 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 değerini 240000 milisaniye (4 dakika) olarak ayarlayan bir karma tablodur. Bu ayar komutun tamamlanması için daha fazla zaman verir. ConfigurationName ve SessionOption parametreleri, Get-PSSession cmdlet'inin her bilgisayarda çalıştığı geçici oturumları yapılandırmak için kullanılır. Çıktı, komutun BackupJob04 oturumunu döndürdüğünü gösterir. Oturumun bağlantısı kesilir ve KullanılabilirlikNone, kullanımda olmadığını gösterir.
İkinci komut, Get-PSSession oturumuna ulaşmak için BackupJob04 cmdlet'ini ve oturuma bağlanmak için Connect-PSSession cmdlet'ini kullanır. komutu oturumu $s değişkenine kaydeder.
Üçüncü komut, $s değişkenindeki oturumu alır. Çıktı, Connect-PSSession komutunun 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, kimliği olan 2 alır.
Kimliği özelliğinin değeri yalnızca geçerli oturumda benzersiz olduğundan, Kimliği 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, Get-PSSession parametresiyle bir komutu ç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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ConnectionUriInstanceId
| 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: | All sessions |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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
Get-PSSession komutunun çalıştığı oturum için kimlik bilgilerinin kimliğini doğrulamak için kullanılan mekanizmayı belirtir.
Bu parametre, Get-PSSession veya ConnectionUri parametresiyle bir komutu çalıştırmak için oluşturulan geçici bağlantıyı yapılandırıyor.
Bu parametre için kabul edilebilir değerler şunlardır:
DefaultBasicCredSSPDigestKerberosNegotiate-
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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | AuthenticationMechanism |
| Default value: | Default |
| Kabul edilen değerler: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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
Get-PSSession komutunun çalıştığı oturumu oluşturma izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın parmak izini girin.
Bu parametre, Get-PSSession veya ConnectionUri parametresiyle bir komutu ç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 Get-Item sürücüsünde bir Get-ChildItem veya Cert: komutu kullanın.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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
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 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 komutu ç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.
Uyarı
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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cn |
Parametre kümeleri
ComputerInstanceId
| 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 |
ComputerName
| 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 |
-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 için bkz. about_Session_Configurations.
Parametre özellikleri
| Tür: | String |
| Default value: | All sessions |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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 |
ContainerId
| 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 |
ContainerIdInstanceId
| 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 |
VMId
| 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 |
VMIdInstanceId
| 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 |
VMName
| 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 |
VMNameInstanceId
| 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
Get-PSSession komutunun çalıştığı geçici oturum için bağlantı uç noktasını tanımlayan bir URI belirtir. URI tam olarak nitelenmiş olmalıdır.
Bu parametre, Get-PSSession parametresiyle bir komutu ç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.
ConnectionUribelirtmezseniz, UseSSL, ComputerName, Bağlantı Noktasıve ApplicationName parametrelerini kullanarak ConnectionURI değerlerini belirtebilirsiniz. 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.
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.
Parametre özellikleri
| Tür: | Uri[] |
| Default value: | Http://localhost:5985/WSMAN |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | URI (Evrensel Kaynak Tanımlayıcısı), CU |
Parametre kümeleri
ConnectionUriInstanceId
| 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 |
-ContainerId
Kapsayıcıların kimlik numaraları dizisini belirtir. Bu cmdlet, belirtilen kapsayıcıların her biriyle etkileşimli bir oturum başlatır. Kapsayıcı kimliklerinin listesini almak için docker ps komutunu kullanın. Daha fazla bilgi için docker ps komutla ilgili yardıma bakın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ContainerId
| Position: | Named |
| 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 |
ContainerIdInstanceId
| Position: | Named |
| 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
Kullanıcı kimlik bilgilerini belirtir. Bu cmdlet, belirtilen kullanıcının izinleriyle komutunu çalıştırır. Uzak bilgisayara bağlanma ve Get-PSSession komutu çalıştırma izni olan bir kullanıcı hesabı belirtin. 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?.
Bu parametre, Get-PSSession veya ConnectionUri parametresiyle bir komutu ç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.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | Current user |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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
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.
Kimliği 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, InstanceIddaha kolaydır, ancak yalnızca geçerli oturum içinde benzersizdir. Oturumun kimliği, oturumun Kimliği özelliğinde depolanır.
Parametre özellikleri
| Tür: | Int32[] |
| Default value: | All sessions |
| 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
Oturumların örnek kimliklerinden oluşan bir dizi belirtir. Bu cmdlet yalnızca belirtilen örnek kimliklerine sahip oturumları alır.
Oturum Kimliği, yerel veya uzak bir bilgisayardaki oturumu benzersiz şekilde tanımlayan bir GUID'dir. InstanceId, PowerShell'de çalışan birden çok oturuma sahip olsanız bile benzersizdir.
Oturumun örnek kimliği, oturumun InstanceId özelliğinde depolanır.
Parametre özellikleri
| Tür: | Guid[] |
| Default value: | All sessions |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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 |
ContainerIdInstanceId
| 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 |
VMIdInstanceId
| 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 |
VMNameInstanceId
| 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: | 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 |
-Name
Oturum adları dizisini belirtir. Bu cmdlet yalnızca belirtilen kolay adlara sahip oturumları alır. Joker karakterlere izin verilir.
Oturumun kolay adı, oturumun Adı özelliğinde depolanır.
Parametre özellikleri
| Tür: | String[] |
| Default value: | All sessions |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
Name
| 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 |
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 |
ContainerId
| 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 |
VMId
| 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 |
VMName
| 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 |
-Port
Get-PSSession komutunun çalıştığı geçici bağlantı için kullanılan belirtilen 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\>
Bu parametre, Get-PSSession veya ConnectionUri parametresiyle bir komutu çalıştırmak için oluşturulan geçici bağlantıya yapılandırılır.
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.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | 5985, 5986 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
-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ğerler de dahil olmak üzere 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
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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 |
-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, farklı bir oturuma bağlı olsalar bile Disconnected durumuna sahiptir.
Oturumun durumu, oturumun Durumu özelliğinde depolanır.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | SessionFilterState |
| Default value: | All |
| Kabul edilen değerler: | All, Opened, Disconnected, Closed, Broken |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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 |
ContainerId
| 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 |
ContainerIdInstanceId
| 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 |
VMId
| 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 |
VMIdInstanceId
| 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 |
VMName
| 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 |
VMNameInstanceId
| 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
Get-PSSession komutunu çalıştırmak için oluşturulabilecek en fazla eşzamanlı bağlantı sayısını belirtir. Bu parametreyi atlar veya 0 (sıfır) değerini girerseniz, varsayılan değer olan 32kullanılır. Hız sınırlaması yalnızca geçerli komut için geçerlidir, oturuma veya bilgisayara uygulanmaz.
Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.
Parametre özellikleri
| Tür: | Int32 |
| Default value: | 32 |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
ConnectionUriInstanceId
| 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 |
-UseSSL
Bu cmdlet'in, Get-PSSession komutunun çalıştığı bağlantıyı kurmak için Güvenli Yuva Katmanı (SSL) protokolunu 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, Get-PSSession parametresiyle bir komutu ç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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
ComputerInstanceId
| 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 |
-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
Parametre özellikleri
| Tür: | Guid[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | VMGuid |
Parametre kümeleri
VMId
| Position: | Named |
| 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 |
VMIdInstanceId
| Position: | Named |
| 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 |
-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 Get-VM cmdlet'ini kullanın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
VMName
| Position: | Named |
| 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 |
VMNameInstanceId
| Position: | Named |
| 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 |
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
None
Nesneleri bu cmdlet'e yöneltemezsiniz.
Çıkışlar
PSSession
Notlar
PowerShell, Get-PSSessioniçin aşağıdaki diğer adları içerir:
Tüm platformlar:
gsn
Bu cmdlet, ,
New-PSSessionveEnter-PSSessioncmdlet'leri kullanılarak oluşturulanlar gibi PSSessionInvoke-Commandkullanıcı tarafından yönetilen oturumları 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.
Get-PSSessionaldığı oturumları filtrelemek için Adı, Kimliği, InstanceIdve State parametrelerini kullanın.Get-PSSessiontarafından kullanılan geçici oturumu yapılandırmak için kalan parametreleri kullanın.ComputerName veya ConnectionUri parametrelerini kullandığınızda,
Get-PSSessionyalnızca PowerShell'in Windows PowerShell 3.0 ve sonraki sürümlerini çalıştıran bilgisayarlardan oturum alır.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. Geçerli oturumdan PSSession bağlanıp bağlanamayacağınızı belirlemek için Kullanılabilirlik özelliğini kullanın.
YokKullanılabilirlik değeri 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.
