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.

cmdlet Disable-PSSessionConfiguration 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, cmdlet Disable-PSSessionConfiguration mengatur pengaturan Diaktifkan dari konfigurasi sesi (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) ke False.

Di PowerShell 2.0, cmdlet Disable-PSSessionConfiguration menambahkan entri Deny_All ke pendeskripsi 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 Force menekan semua perintah pengguna dari cmdlet.

Disable-PSSessionConfiguration -Name Microsoft* -Force

Contoh 4: Menonaktifkan konfigurasi sesi dengan menggunakan alur

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

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

Contoh 5: Efek menonaktifkan konfigurasi sesi

Contoh ini menunjukkan izin sebelum dan sesudah menjalankan 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

Nota

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

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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 untuk Disable-PSSessionConfiguration.

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

Jenis:	String[]
Position:	0
Nilai default:	None
Diperlukan:	False
Terima input alur:	True
Terima karakter wildcard:	True

-NoServiceRestart

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

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-WhatIf

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

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	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.

Bagikan melalui