Enable-PSSessionConfiguration

Modül:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Varsayılan) 

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Enable-PSSessionConfiguration cmdlet'i, Disable-PSSessionConfiguration veya Disable-PSRemoting cmdlet'leri ya da Register-PSSessionConfiguration parametresi kullanılarak 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 , 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ınWSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled özelliğinin 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 AdminShell 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.

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

Parametre kümeleri

(All)
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

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
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

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

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

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:True
DontShow:False

Parametre kümeleri

(All)
Position:0
Zorunlu:False
İşlem hattından gelen değer:True
Ö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

-NoServiceRestart

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
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

-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 tüm reddetme öğesini güvenlik tanımlayıcısından siler.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
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

-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 Set-NetFirewallRule cmdlet'ini kullanın. Daha fazla bilgi için bkz. Enable-PSRemoting.

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

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
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

-WhatIf

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

Parametre özellikleri

Tür:SwitchParameter
Default value:False
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Wi

Parametre kümeleri

(All)
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

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

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 Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatmanız gerekir.