Bagikan melalui

Enable-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Mengaktifkan konfigurasi sesi pada komputer lokal.

Sintaks

Default (Default) 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Cmdlet mengaktifkan kembali konfigurasi sesi terdaftar yang telah dinonaktifkan, seperti dengan menggunakan cmdlet atau , atau parameter AccessMode . Ini adalah cmdlet tingkat lanjut yang dirancang untuk digunakan oleh administrator sistem untuk mengelola konfigurasi sesi yang disesuaikan untuk pengguna mereka.

Tanpa parameter, memungkinkan konfigurasi Microsoft.PowerShell , yang merupakan konfigurasi default yang digunakan untuk sesi.

Enable-PSSessionConfiguration menghapus pengaturan Deny_All dari pendeskripsi keamanan konfigurasi sesi yang terpengaruh, mengaktifkan pendengar yang menerima permintaan pada alamat IP apa pun, dan memulai ulang layanan WinRM. Dimulai di PowerShell 3.0, juga mengatur nilai properti Diaktifkan dari konfigurasi sesi () ke True. Namun, Enable-PSSessionConfiguration tidak menghapus atau mengubah pengaturan pendeskripsi keamanan Network_Deny_All (AccessMode=Local) yang hanya memungkinkan pengguna komputer lokal untuk menggunakan konfigurasi sesi.

Contoh

Contoh 1: Aktifkan kembali sesi default

Contoh ini mengaktifkan kembali konfigurasi sesi default Microsoft.PowerShell di komputer.

Enable-PSSessionConfiguration

Contoh 2: Mengaktifkan kembali sesi yang ditentukan

Contoh ini mengaktifkan kembali MaintenanceShell dan AdminShell konfigurasi sesi di komputer.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Contoh 3: Aktifkan kembali semua sesi

Contoh ini mengaktifkan kembali semua konfigurasi sesi di komputer. Perintah ini setara. Oleh karena itu, Anda juga dapat menggunakannya.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration tidak menghasilkan kesalahan jika Anda mengaktifkan konfigurasi sesi yang sudah diaktifkan.

Contoh 4: Aktifkan kembali sesi dan tentukan deskriptor keamanan baru

Contoh ini mengaktifkan kembali konfigurasi sesi MaintenanceShell dan menentukan deskriptor keamanan baru untuk konfigurasi.

$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

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

Menunjukkan bahwa cmdlet tidak meminta konfirmasi kepada Anda, dan memulai ulang layanan WinRM tanpa meminta. Memulai ulang layanan membuat perubahan konfigurasi efektif.

Untuk mencegah restart dan menekan perintah hidupkan ulang, gunakan parameter NoServiceRestart.

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

Menentukan nama konfigurasi sesi yang akan diaktifkan. Masukkan satu atau beberapa nama konfigurasi. Karakter pengganti diizinkan.

Anda juga dapat menyalurkan string yang berisi nama konfigurasi atau objek konfigurasi sesi untuk Enable-PSSessionConfiguration.

Jika Anda menghilangkan parameter ini, Enable-PSSessionConfiguration mengaktifkan 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

Menunjukkan bahwa cmdlet tidak memulai ulang layanan.

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

-SecurityDescriptorSddl

Menentukan deskriptor keamanan dengan cmdlet ini menggantikan deskriptor keamanan pada konfigurasi sesi.

Jika Anda menghilangkan parameter ini, Enable-PSSessionConfiguration hanya menghapus tolak semua item dari deskriptor keamanan.

Properti parameter

Jenis:String
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

-SkipNetworkProfileCheck

Menunjukkan bahwa cmdlet ini memungkinkan konfigurasi sesi ketika komputer berada di jaringan publik. Parameter ini memungkinkan aturan firewall untuk jaringan publik yang memungkinkan akses jarak jauh hanya dari komputer di subnet lokal yang sama. Secara default, Enable-PSSessionConfiguration gagal pada jaringan publik.

Parameter ini dirancang untuk versi klien sistem operasi Windows. Versi server sistem operasi Windows memiliki aturan firewall subnet lokal untuk jaringan publik. Namun, jika aturan firewall subnet lokal dinonaktifkan pada versi server sistem operasi Windows, parameter ini akan mengaktifkannya kembali.

Untuk menghapus pembatasan subnet lokal dan mengaktifkan akses jarak jauh dari semua lokasi di jaringan publik, gunakan cmdlet Set-NetFirewallRule dalam modul NetSecurity. Untuk informasi selengkapnya, lihat Enable-PSRemoting .

Parameter ini diperkenalkan di PowerShell 3.0.

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 menggunakan cmdlet ini, Anda harus memulai PowerShell dengan menggunakan opsi Jalankan sebagai administrator.