Enable-PSSessionConfiguration

  • Başvuru
Modül:
Microsoft.PowerShell.Core

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

Syntax

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

cmdlet'iEnable-PSSessionConfiguration, veya Disable-PSRemoting cmdlet'lerini veya accessmode parametresini Register-PSSessionConfigurationkullanarak Disable-PSSessionConfiguration devre dışı bırakılmış kayıtlı oturum yapılandırmalarını etkinleştirir. Bu, sistem yöneticileri tarafından kullanıcıları için özelleştirilmiş oturum yapılandırmalarını yönetmek üzere 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 adresinde istekleri kabul eden dinleyiciyi açar ve WinRM hizmetini yeniden başlatır. PowerShell 3.0'da başlayarak, Enable-PSSessionConfiguration oturum yapılandırmasının Enabled özelliğinin (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) değerini de True olarak ayarlar. Ancak, Enable-PSSessionConfiguration yalnızca yerel bilgisayarın kullanıcılarının oturum yapılandırmasında kullanmasına izin veren Network_Deny_All (AccessMode=Local) güvenlik tanımlayıcısı ayarını kaldırmaz veya değiştirmez.

Örnekler

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

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

Enable-PSSessionConfiguration

Örnek 2: Belirtilen oturumları yeniden etkinleştirme

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

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

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

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

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

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

Örnek 4: Oturumu yeniden etkinleştirme ve yeni bir güvenlik tanımlayıcısı belirtme

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ı 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Cmdlet'in sizden onay istemediğini ve sormadan WinRM hizmetini yeniden başlatdığını gösterir. Hizmetin yeniden başlatılması yapılandırma değişikliğini etkili hale getirir.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Etkinleştirecek oturum yapılandırmalarının adlarını belirtir. Bir veya daha fazla yapılandırma adı girin. Joker karakterlere izin verilir.

Yapılandırma adı veya oturum yapılandırma nesnesi içeren bir dizeyi adresine Enable-PSSessionConfigurationde aktarabilirsiniz.

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

Cmdlet'in hizmeti yeniden başlatmadığını gösterir.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

Bu cmdlet'in, bilgisayar bir genel ağda olduğunda oturum yapılandırmasını etkinleştirdiğini gösterir. Bu parametre, ortak ağlar için yalnızca aynı yerel alt ağının bilgisayarlarından uzaktan erişime izin veren bir güvenlik duvarı kuralı sağlar. 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ümleri, genel ağlar için yerel bir alt ağ güvenlik duvarı kuralına sahiptir. Ancak, windows işletim sisteminin sunucu sürümünde yerel alt ağ güvenlik duvarı kuralı devre dışı bırakılırsa, bu parametre yeniden etkinleştirir.

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

Bu parametre PowerShell 3.0'da kullanıma sunulmuştur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Oturum yapılandırma nesnesini bu cmdlet'e yöneltebilirsiniz.

String

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

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

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

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