Disable-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Menonaktifkan konfigurasi sesi pada komputer lokal.

Sintaks

Default (Default) 

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

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

Tanpa parameter, 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 menghilangkan semua perintah 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 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.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Memaksa perintah untuk dijalankan tanpa meminta konfirmasi pengguna.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Name

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

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

Properti parameter

Jenis:

String[]

Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

(All)
Position:0
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-NoServiceRestart

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

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.