Disable-PSSessionConfiguration

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

Yerel bilgisayarda oturum yapılandırmalarını devre dışı bırakır.

Sözdizimi

Disable-PSSessionConfiguration
       [[-Name] <String[]>]
       [-Force]
       [-NoServiceRestart]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Disable-PSSessionConfiguration Cmdlet, tüm kullanıcıların yerel bilgisayarda kullanıcı tarafından yönetilen oturumlar (PSSessions) oluşturmak için oturum yapılandırmalarını kullanmasını engelleyen yerel bilgisayardaki oturum yapılandırmalarını devre dışı bırakır. 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.

PowerShell 3.0'dan Disable-PSSessionConfiguration başlayarak, cmdlet oturum yapılandırmasının (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) Etkin ayarını False olarak ayarlar.

PowerShell 2.0'da cmdlet, Disable-PSSessionConfiguration bir veya daha fazla kayıtlı oturum yapılandırmasının güvenlik tanımlayıcısına bir Deny_All girişi ekler.

Parametreler olmadan, Disable-PSSessionConfiguration oturumlar için kullanılan varsayılan yapılandırma olan Microsoft.PowerShell yapılandırmasını devre dışı bırakır. Kullanıcı farklı bir yapılandırma belirtmediği sürece, hem yerel hem de uzak kullanıcıların bilgisayara bağlanan oturumlar oluşturması etkili bir şekilde engellenir.

Bilgisayardaki tüm oturum yapılandırmalarını devre dışı bırakmak için kullanın Disable-PSRemoting.

Örnekler

Örnek 1: Varsayılan yapılandırmayı devre dışı bırakma

Bu örnek, Microsoft.PowerShell oturum yapılandırmasını devre dışı bırakır.

Disable-PSSessionConfiguration

Örnek 2: Tüm kayıtlı oturum yapılandırmalarını devre dışı bırakma

Bu örnek, bilgisayardaki tüm kayıtlı oturum yapılandırmalarını devre dışı bırakır.

Disable-PSSessionConfiguration -Name *

Örnek 3: Oturum yapılandırmalarını ada göre devre dışı bırakma

Bu örnek, ile Microsoftbaşlayan adlara sahip tüm oturum yapılandırmalarını devre dışı bırakır. Force parametresi, cmdlet'indeki tüm kullanıcı istemlerini gizler.

Disable-PSSessionConfiguration -Name Microsoft* -Force

Örnek 4: İşlem hattını kullanarak oturum yapılandırmalarını devre dışı bırakma

Bu örnek MaintenanceShell ve AdminShell oturum yapılandırmalarını devre dışı bırakır. İşlem hattı işleci (|), ' Get-PSSessionConfiguration nin sonuçlarını adresine Disable-PSSessionConfigurationgönderir.

Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

Örnek 5: Oturum yapılandırmasını devre dışı bırakmanın etkileri

Bu örnekte, çalıştırma Disable-PSSessionConfiguration öncesi ve sonrasındaki izinler ve oturum yapılandırmasını devre dışı bırakmanın etkisi gösterilmektedir.

PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message : Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed

Not

Yapılandırmayı devre dışı bırakmak, cmdlet'ini kullanarak yapılandırmayı Set-PSSessionConfiguration değiştirmenizi engellemez. Yalnızca yapılandırmanın kullanılmasını engeller.

Parametreler

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Name

Devre dışı bırakacak oturum yapılandırmalarının ad dizisini 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 Disable-PSSessionConfigurationde aktarabilirsiniz.

Bu parametreyi atlarsanız, Disable-PSSessionConfiguration Microsoft.PowerShell oturum yapılandırmasını devre dışı bırakır.

Tür:String[]
Position:0
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-NoServiceRestart

WSMan hizmetinin yeniden başlatılmasını önlemek için kullanılır. Yapılandırmayı devre dışı bırakmak için hizmeti yeniden başlatmak gerekmez.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatmanız gerekir.