Etkinleştirme-PSSessionConfiguration (Microsoft.PowerShell.Core)

Etkinleştirme-PSSessionConfiguration

Modül:

Microsoft.PowerShell.Core

Yerel bilgisayardaki oturum yapılandırmalarını etkinleştirir.

Sözdizimi

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Enable-PSSessionConfiguration cmdlet'i, örneğin Disable-PSSessionConfiguration veya Disable-PSRemoting cmdlet'leri kullanılarak devre dışı bırakılmış kayıtlı oturum yapılandırmalarını etkinleştirir veya Register-PSSessionConfiguration'un AccessMode parametresi. Bu, sistem yöneticileri tarafından, kullanıcıları için özelleştirilmiş oturum yapılandırmalarını yönetmek amacıyla kullanılmak üzere tasarlanmış gelişmiş bir cmdlet'tir.

Parametreler olmadan Enable-PSSessionConfiguration, oturumlar için kullanılan varsayılan yapılandırma olan Microsoft.PowerShell yapılandırmasını etkinleştirir.

Enable-PSSessionConfiguration, etkilenen oturum yapılandırmalarının güvenlik tanımlayıcısından Deny_All ayarını kaldırır, herhangi bir IP adresinden istekleri kabul eden dinleyiciyi açar ve WinRM hizmetini yeniden başlatır. PowerShell 3.0'dan başlayarak, Enable-PSSessionConfiguration ayrıca oturum yapılandırmasının Enabled özelliğinin değerini de ayarlar (WSMan:\\PlugIn\ \Enabled) öğesini True olarak değiştirin. Ancak Enable-PSSessionConfiguration, yalnızca yerel bilgisayar kullanıcılarının şunları yapmasına izin veren Network_Deny_All (AccessMode=Local) güvenlik tanımlayıcı ayarını kaldırmaz veya değiştirmez. oturum yapılandırmasını kullanın.

Örnekler

Örnek 1: Varsayılan oturumu yeniden etkinleştirin

Bu örnek, bilgisayardaki Microsoft.PowerShell varsayılan oturum yapılandırmasını yeniden etkinleştirir.

Enable-PSSessionConfiguration

Örnek 2: Belirtilen oturumları yeniden etkinleştirin

Bu örnek, bilgisayardaki MaintenanceShell ve AdminShell oturum yapılandırmalarını yeniden etkinleştirir.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Örnek 3: Tüm oturumları yeniden etkinleştirin

Bu örnek, bilgisayardaki tüm oturum yapılandırmalarını yeniden etkinleştirir. Bu komutlar eşdeğerdir. Bu nedenle ikisini de kullanabilirsiniz.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Zaten etkinleştirilmiş bir oturum yapılandırmasını etkinleştirirseniz Enable-PSSessionConfiguration hata oluşturmaz.

Örnek 4: Bir oturumu yeniden etkinleştirin ve yeni bir güvenlik tanımlayıcısı belirtin

Bu örnek, MaintenanceShell oturum yapılandırmasını yeniden etkinleştirir ve yapılandırma için yeni bir güvenlik tanımlayıcısını belirtir.

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Force

Cmdlet'in sizden onay istemediğini ve WinRM hizmetini sormadan yeniden başlattığını belirtir. Hizmetin yeniden başlatılması, yapılandırma değişikliğinin etkili olmasını sağlar.

Yeniden başlatmayı önlemek ve yeniden başlatma istemini bastırmak için NoServiceRestart parametresini kullanın.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Name

Etkinleştirilecek oturum yapılandırmalarının adlarını belirtir. Bir veya daha fazla konfigürasyon adı girin. Joker karakterlere izin verilir.

Ayrıca bir yapılandırma adı veya oturum yapılandırma nesnesi içeren bir dizeyi Enable-PSSessionConfiguration'a aktarabilirsiniz.

Bu parametreyi atlarsanız Enable-PSSessionConfiguration, Microsoft.PowerShell oturum yapılandırmasını etkinleştirir.

Tip :

String[]

Konum:

0

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-NoServiceRestart

Cmdlet'in hizmeti yeniden başlatmadığını belirtir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-SecurityDescriptorSddl

Bu cmdlet'in oturum yapılandırmasındaki güvenlik tanımlayıcısının yerini alacağı bir güvenlik tanımlayıcısını belirtir.

Bu parametreyi atlarsanız, Enable-PSSessionConfiguration yalnızca güvenlik tanımlayıcısındaki tümünü reddet öğesini siler.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-SkipNetworkProfileCheck

Bu cmdlet'in, bilgisayar genel bir ağda olduğunda oturum yapılandırmasını etkinleştirdiğini belirtir. Bu parametre, genel ağlar için yalnızca aynı yerel alt ağdaki bilgisayarlardan uzaktan erişime izin veren bir güvenlik duvarı kuralını etkinleştirir. Varsayılan olarak, Enable-PSSessionConfiguration genel ağda başarısız olur.

Bu parametre, Windows işletim sisteminin istemci sürümleri için tasarlanmıştır. Windows işletim sisteminin sunucu sürümlerinde genel ağlar için yerel bir alt ağ güvenlik duvarı kuralı bulunur. Ancak, Windows işletim sisteminin bir sunucu sürümünde yerel alt ağ güvenlik duvarı kuralı devre dışıysa bu parametre onu yeniden etkinleştirir.

Yerel alt ağ kısıtlamasını kaldırmak ve genel ağlardaki tüm konumlardan uzaktan erişimi etkinleştirmek için NetSecurity modülündeki Set-NetFirewallRule cmdlet'ini kullanın. Daha fazla bilgi için bkz. PSRemoting'i Etkinleştirme.

Bu parametre PowerShell 3,0'da tanıtıldı.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Bir oturum yapılandırma nesnesini bu cmdlet'e aktarabilirsiniz.

Dize

Bir oturum yapılandırmasının adını içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.

Notlar

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

Bu cmdlet'i kullanmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatmanız gerekir.