Enable-PSSessionConfiguration

  • Referensi
Modul:
Microsoft.PowerShell.Core

Mengaktifkan konfigurasi sesi pada komputer lokal.

Sintaks

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Enable-PSSessionConfiguration Cmdlet memungkinkan konfigurasi sesi terdaftar yang telah dinonaktifkan, seperti dengan menggunakan Disable-PSSessionConfiguration cmdlet atau Disable-PSRemoting , atau parameter AccessMode dari Register-PSSessionConfiguration. Ini adalah cmdlet tingkat lanjut yang dirancang untuk digunakan oleh administrator sistem untuk mengelola konfigurasi sesi yang disesuaikan untuk pengguna mereka.

Tanpa parameter, Enable-PSSessionConfiguration mengaktifkan konfigurasi Microsoft.PowerShell , yang merupakan konfigurasi default yang digunakan untuk sesi.

Enable-PSSessionConfigurationmenghapus 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, Enable-PSSessionConfiguration juga mengatur nilai properti Diaktifkan dari konfigurasi sesi (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) ke True. Namun, Enable-PSSessionConfiguration tidak menghapus atau mengubah pengaturan deskriptor keamanan Network_Deny_All (AccessMode=Local) yang hanya memungkinkan pengguna komputer lokal untuk digunakan ke 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 konfigurasi sesi MaintenanceShell dan AdminShell 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 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

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 .

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

-Name

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

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

Jika Anda menghilangkan parameter ini, Enable-PSSessionConfiguration mengaktifkan konfigurasi sesi Microsoft.PowerShell .

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

-NoServiceRestart

Menunjukkan bahwa cmdlet tidak memulai ulang layanan.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Set-NetFirewallRule cmdlet dalam modul NetSecurity. Untuk informasi selengkapnya, lihat Enable-PSRemoting .

Parameter ini diperkenalkan di PowerShell 3.0.

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