Unregister-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Menghapus konfigurasi sesi terdaftar dari komputer.

Sintaks

Default (Default) 

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

cmdlet Unregister-PSSessionConfiguration menghapus konfigurasi sesi terdaftar dari komputer. Cmdlet ini dirancang untuk administrator sistem untuk mengelola konfigurasi sesi yang disesuaikan bagi pengguna.

Agar perubahan efektif, Unregister-PSSessionConfiguration memulai ulang layanan WinRM. Untuk mencegah hidupkan ulang, tentukan parameter NoServiceRestart.

Jika Anda secara tidak sengaja menghapus konfigurasi sesi Microsoft.PowerShell atau Microsoft.PowerShell32 default, gunakan cmdlet Enable-PSRemoting untuk memulihkannya. Untuk informasi selengkapnya, lihat about_Session_Configurations.

Contoh

Contoh 1: Menghapus konfigurasi sesi

Contoh ini menghapus konfigurasi sesi MaintenanceShell dari komputer.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Contoh 2: Menghapus konfigurasi sesi dan memulai ulang layanan WinRM

Dalam contoh ini, kami menghapus konfigurasi MaintenanceShell dan memulai ulang layanan WinRM. Parameter Force menekan semua pesan pengguna untuk memulai ulang layanan WinRM tanpa meminta.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Contoh 3: Menghapus semua konfigurasi sesi

Contoh ini menunjukkan dua cara untuk menghapus semua konfigurasi sesi di komputer. Kedua perintah memiliki efek yang sama dan dapat digunakan secara bergantian.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Contoh 4: Membatalkan pendaftaran tanpa menghidupkan ulang

Contoh ini menunjukkan efek menggunakan parameter NoServiceRestart untuk mencegah hidupkan ulang layanan yang akan mengganggu sesi apa pun di komputer.

PS> Unregister-PSSessionConfiguration -Name "MaintenanceShell" -NoServiceRestart
PS> Get-PSSessionConfiguration -Name "MaintenanceShell"

Get-PSSessionConfiguration -Name MaintenanceShell : No Session Configuration matches criteria "MaintenanceShell".
+ CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException

PS> New-PSSession -ConfigurationName "MaintenanceShell"

Id Name      ComputerName    State    Configuration         Availability
-- ----      ------------    -----    -------------         ------------
1 Session1  localhost       Opened   MaintenanceShell      Available

PS> Restart-Service winrm
PS> New-PSSession -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message :
 The WS-Management service cannot process the request.
 The resource URI (http://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog.
 The catalog contains the metadata that describes resources, or logical endpoints.
 For more information, see the about_Remote_Troubleshooting Help topic.
 + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
 + FullyQualifiedErrorId : PSSessionOpenFailed

Unregister-PSSessionConfiguration menghapus konfigurasi sesi MaintenanceShell. Namun, karena perintah menggunakan parameter NoServiceRestart, layanan WinRM tidak dimulai ulang dan perubahan belum sepenuhnya efektif.

Selanjutnya, Get-PSSessionConfiguration mencoba mendapatkan sesi MaintenanceShell. Karena sesi telah dihapus dari tabel sumber daya WS-Management, Get-PSSessionConfiguration tidak dapat mengembalikannya.

Cmdlet New-PSSession membuat sesi menggunakan konfigurasi MaintenanceShell. Perintah berhasil. Selanjutnya, kita mulai ulang layanan WinRM.

Terakhir, cmdlet New-PSSession mencoba membuat sesi yang menggunakan konfigurasi MaintenanceShell. Kali ini, sesi gagal karena konfigurasi MaintenanceShell dihapus saat layanan WinRM dimulai ulang.

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 dihapus. Masukkan satu nama konfigurasi sesi atau pola nama konfigurasi. Karakter pengganti diizinkan. Parameter ini diperlukan.

Anda juga dapat menyalurkan konfigurasi sesi ke Unregister-PSSessionConfiguration.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:True
DontShow:False

Kumpulan parameter

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

-NoServiceRestart

Menunjukkan bahwa cmdlet ini tidak memulai ulang layanan WinRM, dan menekan perintah untuk memulai ulang layanan.

Secara default, ketika Anda menjalankan perintah Unregister-PSSessionConfiguration, Anda diminta untuk memulai ulang layanan WinRM agar perubahan efektif. Hingga layanan WinRM dimulai ulang, pengguna masih dapat menggunakan konfigurasi sesi yang tidak terdaftar, meskipun Get-PSSessionConfiguration tidak menemukannya.

Untuk memulai ulang layanan WinRM tanpa meminta, tentukan parameter Force. Untuk memulai ulang layanan WinRM secara manual, gunakan cmdlet Restart-Service.

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.

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.