Disable-PSSessionConfiguration

  • Referensi
Modul:
Microsoft.PowerShell.Core

Menonaktifkan konfigurasi sesi pada komputer lokal.

Sintaks

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Disable-PSSessionConfiguration Cmdlet menonaktifkan konfigurasi sesi di komputer lokal, yang mencegah semua pengguna menggunakan konfigurasi sesi untuk membuat sesi yang dikelola pengguna (PSSessions) di komputer lokal. Ini adalah cmdlet tingkat lanjut yang dirancang untuk digunakan oleh administrator sistem untuk mengelola konfigurasi sesi yang disesuaikan untuk pengguna mereka.

Dimulai di PowerShell 3.0, Disable-PSSessionConfiguration cmdlet mengatur pengaturan Diaktifkan dari konfigurasi sesi (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) ke False.

Di PowerShell 2.0, Disable-PSSessionConfiguration cmdlet menambahkan entri Deny_All ke deskriptor keamanan dari satu atau beberapa konfigurasi sesi terdaftar.

Tanpa parameter, Disable-PSSessionConfiguration menonaktifkan konfigurasi Microsoft.PowerShell , konfigurasi default yang digunakan untuk sesi. Kecuali pengguna menentukan konfigurasi yang berbeda, pengguna lokal dan jarak jauh secara efektif dicegah untuk membuat sesi apa pun yang terhubung ke komputer.

Untuk menonaktifkan semua konfigurasi sesi di komputer, gunakan Disable-PSRemoting.

Contoh

Contoh 1: Menonaktifkan konfigurasi default

Contoh ini menonaktifkan konfigurasi sesi Microsoft.PowerShell .

Disable-PSSessionConfiguration

Contoh 2: Menonaktifkan semua konfigurasi sesi terdaftar

Contoh ini menonaktifkan semua konfigurasi sesi terdaftar di komputer.

Disable-PSSessionConfiguration -Name *

Contoh 3: Menonaktifkan konfigurasi sesi berdasarkan nama

Contoh ini menonaktifkan semua konfigurasi sesi yang memiliki nama yang dimulai dengan Microsoft. Parameter Paksa menekan semua permintaan pengguna dari cmdlet.

Disable-PSSessionConfiguration -Name Microsoft* -Force

Contoh 4: Menonaktifkan konfigurasi sesi dengan menggunakan alur

Contoh ini menonaktifkan konfigurasi sesi MaintenanceShell dan AdminShell . Operator alur (|) mengirimkan hasil ke Get-PSSessionConfigurationDisable-PSSessionConfiguration.

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

Contoh 5: Efek menonaktifkan konfigurasi sesi

Contoh ini menunjukkan izin sebelum dan sesudah berjalan Disable-PSSessionConfiguration dan efek menonaktifkan konfigurasi sesi.

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

Catatan

Menonaktifkan konfigurasi tidak mencegah Anda mengubah konfigurasi menggunakan Set-PSSessionConfiguration cmdlet. Ini hanya mencegah penggunaan konfigurasi.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

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

-Name

Menentukan array nama konfigurasi sesi untuk dinonaktifkan. Masukkan satu atau beberapa nama konfigurasi. Karakter kartubebas diizinkan. Anda juga dapat menyalurkan string yang berisi nama konfigurasi atau objek konfigurasi sesi ke Disable-PSSessionConfiguration.

Jika Anda menghilangkan parameter ini, Disable-PSSessionConfiguration nonaktifkan konfigurasi sesi Microsoft.PowerShell .

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

-NoServiceRestart

Digunakan untuk mencegah menghidupkan ulang layanan WSMan. Tidak perlu menghidupkan ulang layanan untuk menonaktifkan konfigurasi.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Anda dapat menyalurkan objek konfigurasi sesi ke cmdlet ini.

String

Anda dapat menyalurkan string yang berisi nama konfigurasi sesi ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Cmdlet ini hanya tersedia di platform Windows.

Untuk menjalankan cmdlet ini, Anda harus memulai PowerShell dengan menggunakan opsi Jalankan sebagai administrator .