about_Session_Configurations

Kısa açıklama

Bilgisayara uzaktan bağlanabilen kullanıcıları ve çalıştırabilecekleri komutları belirleyen oturum yapılandırmalarını açıklar.

Uzun açıklama

"Uç nokta" olarak da bilinen oturum yapılandırması, yerel bilgisayardaki uzak veya yerel kullanıcılar yerel bilgisayardaki PowerShell'e bağlandığında oluşturulan PowerShell oturumlarının ortamını tanımlayan bir ayar grubudur.

Bilgisayarın Yönetici istrator'ları, bilgisayarı korumak ve bilgisayara bağlanan kullanıcılar için özel ortamlar tanımlamak için oturum yapılandırmalarını kullanabilir.

Yönetici istrator'lar, bilgisayara uzaktan bağlanmak için gereken izinleri belirlemek için oturum yapılandırmalarını da kullanabilir. Varsayılan olarak, yalnızca Yönetici istrators grubunun üyeleri uzaktan bağlanmak için oturum yapılandırmasını kullanma iznine sahiptir, ancak varsayılan ayarları tüm kullanıcıların veya seçili kullanıcıların bilgisayarınıza uzaktan bağlanmasına izin verecek şekilde değiştirebilirsiniz.

PowerShell 3.0'da başlayarak, oturum yapılandırmasının öğelerini tanımlamak için bir oturum yapılandırma dosyası kullanabilirsiniz. Bu özellik, kod yazmadan oturumları özelleştirmeyi ve oturum yapılandırmasının özelliklerini bulmayı kolaylaştırır. Oturum yapılandırma dosyası oluşturmak için New-PSSessionConfiguration cmdlet'ini kullanın. Oturum yapılandırma dosyaları hakkında daha fazla bilgi için bkz . about_Session_Configuration_Files.

Oturum yapılandırmaları, WSMAN tabanlı PowerShell uzaktan iletişiminin bir özelliğidir. Bunlar yalnızca uzak bir Windows bilgisayarına New-PSSessionbağlanmak için , Invoke-Commandveya Enter-PSSession cmdlet'lerini kullandığınızda kullanılır.

Windows bilgisayarda oturum yapılandırmalarını yönetmek için PowerShell'i Yönetici olarak çalıştır seçeneğiyle başlatın.

Oturum Yapılandırmaları Hakkında

Her PowerShell oturumu bir oturum yapılandırması kullanır. Bu, New-PSSession veya Enter-PSSession cmdlet'lerini kullanarak oluşturduğunuz kalıcı oturumları ve Invoke-Command gibi WS-Management tabanlı uzaktan iletişim teknolojisini kullanan bir cmdlet'in ComputerName parametresini kullandığınızda PowerShell'in oluşturduğu geçici oturumları içerir.

Yönetici istrator'lar, bilgisayarın kaynaklarını korumak ve bilgisayara bağlanan kullanıcılar için özel ortamlar oluşturmak için oturum yapılandırmalarını kullanabilir. Örneğin, bilgisayarın oturumda aldığı nesnelerin boyutunu sınırlamak, oturumun dil modunu tanımlamak ve oturumda kullanılabilen cmdlet'leri, sağlayıcıları ve işlevleri belirtmek için bir oturum yapılandırması kullanabilirsiniz.

Oturum yapılandırmasının güvenlik tanımlayıcısını yapılandırarak, bilgisayara bağlanmak için oturum yapılandırmasını kimlerin kullanabileceğini belirlersiniz. Kullanıcıların oturumda kullanabilmesi için oturum yapılandırmasında Yürütme iznine sahip olması gerekir. Bir kullanıcı bilgisayardaki oturum yapılandırmalarından herhangi birini kullanmak için gerekli izinlere sahip değilse, kullanıcı bilgisayara uzaktan bağlanamaz.

Varsayılan olarak, yalnızca bilgisayarın Yönetici istrator'ları varsayılan oturum yapılandırmalarını kullanma iznine sahiptir. Ancak, herkesin, kimsenin veya yalnızca seçili kullanıcıların bilgisayarınızdaki oturum yapılandırmalarını kullanmasına izin vermek için güvenlik tanımlayıcılarını değiştirebilirsiniz.

Yerleşik Oturum Yapılandırmaları

PowerShell 3.0, Microsoft.PowerShell ve Microsoft.PowerShell.Workflow adlı yerleşik oturum yapılandırmalarını içerir. Windows'un 64 bit sürümlerini çalıştıran bilgisayarlarda PowerShell, 32 bit oturum yapılandırması olan Microsoft.PowerShell32'yi de sağlar.

Microsoft.PowerShell oturum yapılandırması varsayılan olarak oturumlar için kullanılır; yani oturum oluşturma komutu New-PSSession, Enter-PSSession veya Invoke-Command cmdlet'inin ConfigurationName parametresini içermez.

Varsayılan oturum yapılandırmaları için güvenlik tanımlayıcıları yalnızca yerel bilgisayardaki Yönetici istrators grubunun üyelerinin bunları kullanmasına izin verir. Bu nedenle, varsayılan ayarları değiştirmediğiniz sürece yalnızca Yönetici istrators grubunun üyeleri bilgisayara uzaktan bağlanabilir.

$PSSessionConfigurationName tercih değişkenini kullanarak varsayılan oturum yapılandırmalarını değiştirebilirsiniz. Daha fazla bilgi için bkz. about_Preference_Variables.

Yerel Bilgisayarda Oturum Yapılandırmalarını Görüntüleme

Oturum yapılandırmalarını yerel bilgisayarınıza almak için Get-PSSessionConfiguration cmdlet'ini kullanın.

Örneğin, şunu yazın:

PS C:> Get-PSSessionConfiguration | Format-List -Property Name, Permission

Name       : microsoft.powershell
Permission : BUILTIN\Administrators AccessAllowed

Name       : microsoft.powershell.workflow
Permission : BUILTIN\Administrators AccessAllowed

Name       : microsoft.powershell32
Permission : BUILTIN\Administrators AccessAllowed

Oturum yapılandırma nesnesi, oturum yapılandırma dosyası kullanılarak yapılandırılan oturum yapılandırmasının özelliklerini görüntülemek için PowerShell 3.0'da genişletilir.

Örneğin, bir oturum yapılandırma nesnesinin tüm özelliklerini görmek için şunu yazın:

PS C:> Get-PSSessionConfiguration | Format-List -Property *

Oturum yapılandırmalarını görüntülemek için PowerShell'de WSMan sağlayıcısını da kullanabilirsiniz. WSMan sağlayıcısı oturumunuzda bir WSMAN: sürücüsü oluşturur.

WSMAN: sürücüsünde oturum yapılandırmaları Eklenti düğümündedir. (Tüm oturum yapılandırmaları Eklenti düğümündedir, ancak Eklenti düğümünde oturum yapılandırmaları olmayan öğeler vardır.)

Örneğin, yerel bilgisayardaki oturum yapılandırmalarını görüntülemek için şunu yazın:

PS C:> dir wsman:\localhost\plugin\microsoft*

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Type       Keys                              Name
----       ----                              ----
Container  {Name=microsoft.powershell}       microsoft.powershell
Container  {Name=microsoft.powershell.wor... microsoft.powershell.workflow
Container  {Name=microsoft.powershell32}     microsoft.powershell32

Uzak Bilgisayarda Oturum Yapılandırmalarını Görüntüleme

Uzak bilgisayardaki oturum yapılandırmalarını görüntülemek için Bağlan-WSMan cmdlet'ini kullanarak uzak bilgisayar için yerel bilgisayarınızdaki WSMAN: sürücüsüne bir not ekleyin ve ardından oturum yapılandırmalarını görüntülemek için WSMAN: sürücüsünü kullanın.

Örneğin, aşağıdaki komut Server01 uzak bilgisayarı için WSMAN: yerel bilgisayardaki sürücüye bir düğüm ekler.

PS C:> Connect-WSMan server01.corp.fabrikam.com

Komut tamamlandığında, oturum yapılandırmalarını görüntülemek için Server01 bilgisayarının düğümüne gidebilirsiniz.

Örneğin:

PS C:> cd wsman:

PS WSMan:> dir

ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01.corp.fabrikam.com                    Container

PS WSMan:> dir server01\plugin\

WSManConfig: Microsoft.WSMan.Management\WSMan::server01.corp.fabrikam.com\Pl
ugin

Type       Keys                              Name
----       ----                              ----
Container  {Name=microsoft.powershell}       microsoft.powershell
Container  {Name=microsoft.powershell.wor... microsoft.powershell.workflow
Container  {Name=microsoft.powershell32}     microsoft.powershell32

Oturum Yapılandırmasının Güvenlik Tanımlayıcısını Değiştirme

Windows Server 2012 ve Windows Server'ın daha yeni sürümlerinde, yerleşik oturum yapılandırmaları varsayılan olarak uzak kullanıcılar için etkinleştirilir. Windows'un desteklenen diğer sürümlerinde, uzaktan erişime izin vermek için oturum yapılandırmalarının güvenlik tanımlayıcılarını değiştirmeniz gerekir.

Bilgisayardaki oturum yapılandırmalarına uzaktan erişimi etkinleştirmek için Enable-PSRemoting cmdlet'ini kullanın. Bu cmdlet iki oturum yapılandırması oluşturur:

  • adı şu şekilde tanımlanmıştır: "PowerShell." + "geçerli PowerShell sürümü"
  • adı "PowerShell.6" olan, belirli bir PowerShell sürümüyle çözülen.

Ayrıca, varsayılan olarak, yalnızca bilgisayardaki Yönetici istrators grubunun üyeleri varsayılan oturum yapılandırmaları üzerinde Yürütme iznine sahiptir, ancak varsayılan oturum yapılandırmalarında ve oluşturduğunuz tüm oturum yapılandırmalarında güvenlik tanımlayıcılarını değiştirebilirsiniz.

Diğer kullanıcılara bilgisayara uzaktan bağlanma izni vermek için Set-PSSessionConfiguration cmdlet'ini kullanarak bu kullanıcılar için Microsoft.PowerShell ve Microsoft.PowerShell32 oturum yapılandırmalarının güvenlik tanımlayıcılarına "Yürüt" izinleri ekleyin.

Örneğin, aşağıdaki komut Microsoft.PowerShell varsayılan oturum yapılandırması için güvenlik tanımlayıcısını değiştirmenize olanak tanıyan bir özellik sayfası açar.

Set-PSSessionConfiguration -name Microsoft.PowerShell `
  -ShowSecurityDescriptorUI

Bilgisayardaki tüm oturum yapılandırmalarına herkesin iznini reddetmek için Disable-PSSessionConfiguration cmdlet'ini kullanın. Örneğin, aşağıdaki komut bilgisayardaki varsayılan oturum yapılandırmalarını devre dışı bırakır.

PS C:> Disable-PSSessionConfiguration -Name Microsoft.PowerShell

Uzak kullanıcıların bilgisayara bağlanmasını engellemek, ancak yerel kullanıcıların bağlanmasına izin vermek için Disable-PSRemoting cmdlet'ini kullanın. Disable-PSRemoting, bilgisayardaki tüm oturum yapılandırmalarına bir "Network_Deny_All" girişi ekler.

PS C:> Disable-PSRemoting

Uzak kullanıcıların bilgisayardaki tüm oturum yapılandırmalarını kullanmasına izin vermek için Enable-PSRemoting veya Enable-PSSessionConfiguration cmdlet'ini kullanın. Örneğin, aşağıdaki komut yerleşik oturum yapılandırmalarına uzaktan erişim sağlar.

PS C:> Enable-PSSessionConfiguration -name Microsoft.Power*

Oturum yapılandırmasının güvenlik tanımlayıcısına başka değişiklikler yapmak için Set-PSSessionConfiguration cmdlet'ini kullanın. SDDL dize değeri göndermek için SecurityDescriptorSDDL parametresini kullanın. Yeni bir SDDL oluşturmanıza yardımcı olan bir kullanıcı arabirimi özellik sayfası görüntülemek için ShowSecurityDescriptorUI parametresini kullanın.

Örneğin:

Set-PSSessionConfiguration -Name Microsoft.PowerShell `
  -ShowSecurityDescriptorUI

Yeni Oturum Yapılandırması Oluşturma

Yerel bilgisayarda yeni bir oturum yapılandırması oluşturmak için Register-PSSessionConfiguration cmdlet'ini kullanın. Yeni oturum yapılandırmasını tanımlamak için C# derlemesi, PowerShell betiği ve Register-PSSessionConfiguration cmdlet'inin parametrelerini kullanabilirsiniz.

Örneğin, aşağıdaki komut, uzak bir komuttan alınan verileri 20 megabayt (MB) ile sınırlaması dışında Microsoft.PowerShell oturum yapılandırmasıyla aynı olan bir oturum yapılandırması oluşturur. (Varsayılan değer 50 MB'tır).

Register-PSSessionConfiguration -Name NewConfig `
  -MaximumReceivedDataSizePerCommandMB 20

Bir oturum yapılandırması oluşturduğunuzda, bunu diğer oturum yapılandırma cmdlet'lerini kullanarak yönetebilirsiniz ve WSMAN: sürücüsünde görünür.

Daha fazla bilgi için bkz. Register-PSSessionConfiguration.

Oturum Yapılandırmasını Kaldırma

Yerel bilgisayardan oturum yapılandırmasını kaldırmak için Unregister-PSSessionConfiguration cmdlet'ini kullanın. Örneğin, aşağıdaki komut NewConfig oturum yapılandırmasını bilgisayardan kaldırır.

PS C:> Unregister-PSSessionConfiguration -Name NewConfig

Daha fazla bilgi için bkz. Unregister-PSSessionConfiguration.

Oturum Yapılandırmasını Geri Yükleme

Yanlışlıkla silinmiş (kaydı kaldırılmış) varsayılan bir oturum yapılandırmasını geri yüklemek için Enable-PSRemoting cmdlet'ini kullanın.

Enable-PSRemoting cmdlet'i, bilgisayarda bulunmayan tüm varsayılan oturum yapılandırmalarını yeniden oluşturur. Mevcut oturum yapılandırmalarının özellik değerlerinin üzerine yazmaz veya değiştirmez.

Varsayılan oturum yapılandırmasının özgün özellik değerlerini geri yüklemek için Unregister-PSSessionConfiguration komutunu kullanarak oturum yapılandırmasını silin ve ardından Enable-PSRemoting cmdlet'ini kullanarak yeniden oluşturun.

Oturum Yapılandırması Seçme

Bir oturum için belirli bir oturum yapılandırmasını seçmek için New-PSSession, Enter-PSSession veya Invoke-Command ConfigurationName parametresini kullanın.

Örneğin, bu komut Server01 bilgisayarında pssession başlatmak için New-PSSession cmdlet'ini kullanır. Komut, Server01 bilgisayarında WithProfile yapılandırmasını seçmek için ConfigurationName parametresini kullanır.

PS C:> New-PSSession -ComputerName Server01 -ConfigurationName WithProfile

Bu komut yalnızca geçerli kullanıcının WithProfile oturum yapılandırmasını kullanma iznine sahip olması veya gerekli izinlere sahip bir kullanıcının kimlik bilgilerini sağlayabilmesi durumunda başarılı olur.

Bilgisayardaki varsayılan oturum yapılandırmasını değiştirmek için $PSSessionConfigurationName tercih değişkenini de kullanabilirsiniz. $PSSessionConfigurationName tercih değişkeni hakkında daha fazla bilgi için bkz. about_Preference_Variables.

ANAHTAR KELİME -LER

about_Endpoints about_SessionConfigurations

Ayrıca bkz.