Bagikan melalui

Remove-PSSnapin

  • Referensi
Modul:
Microsoft.PowerShell.Core

Menghapus snap-in Windows PowerShell dari sesi saat ini.

Sintaks

Remove-PSSnapin
      [-Name] <String[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Remove-PSSnapin Cmdlet menghapus snap-in Windows PowerShell dari sesi saat ini. Anda dapat menggunakannya untuk menghapus snap-in yang telah Anda tambahkan ke Windows PowerShell Anda tidak dapat menggunakan cmdlet ini untuk menghapus snap-in yang diinstal dengan Windows PowerShell.

Setelah Anda menghapus snap-in dari sesi saat ini, snap-in masih dimuat, tetapi cmdlet dan penyedia di snap-in tidak lagi tersedia dalam sesi.

Contoh

Contoh 1: Menghapus snap-in

Remove-PSSnapin -Name Microsoft.Exchange

Perintah ini menghapus snap-in Microsoft.Exchange dari sesi saat ini. Ketika perintah selesai, cmdlet dan penyedia yang didukung snap-in tidak tersedia dalam sesi.

Contoh 2: Menghapus snap-in dengan menggunakan nama dengan alur

Get-PSSnapIn smp* | Remove-PSSnapIn

Perintah ini menghapus snap-in Windows PowerShell yang memiliki nama yang dimulai dengan smp dari sesi saat ini.

Perintah menggunakan Get-PSSnapin cmdlet untuk mendapatkan objek yang mewakili snap-in. Operator alur (|) mengirimkan hasil ke Remove-PSSnapin cmdlet, yang menghapusnya dari sesi. Penyedia dan cmdlet yang didukung snap-in ini tidak lagi tersedia dalam sesi.

Saat Anda menyalurkan objek ke Remove-PSSnapin, nama objek dikaitkan dengan parameter Nama , yang menerima objek dari alur yang memiliki properti Nama .

Contoh 3: Menghapus snap-in dengan menggunakan nama

Remove-PSSnapin -Name *event*

Perintah ini menghapus semua snap-in Windows PowerShell yang memiliki nama yang menyertakan peristiwa.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Name

Menentukan nama snap-in Windows PowerShell untuk dihapus dari sesi saat ini. Karakter kartubebas (*) diizinkan.

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

-PassThru

Mengembalikan objek yang mewakili snap-in. Secara default, cmdlet ini tidak menghasilkan output apa pun.

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

PSSnapInInfo

Anda dapat menyalurkan objek snap-in ke cmdlet ini.

Output

None, System.Management.Automation.PSSnapInInfo

Cmdlet ini menghasilkan objek System.Management.Automation.PSSnapInfo yang mewakili snap-in, jika Anda menentukan parameter PassThru . Secara default, Remove-PSSnapin tidak menghasilkan output apa pun.

Catatan

Windows PowerShell menyertakan alias berikut untuk Remove-PSSnapin:

  • rsnp

Remove-PSSnapin tidak memeriksa versi Windows PowerShell sebelum menghapus snap-in dari sesi. Jika snap-in tidak dapat dihapus, peringatan akan muncul dan perintah gagal.

Remove-PSSnapin hanya memengaruhi sesi saat ini. Jika Anda telah menambahkan Add-PSSnapin perintah ke profil Windows PowerShell, Anda harus menghapus perintah untuk menghapus snap-in dari sesi mendatang. Untuk instruksi, ketik Get-Help about_Profiles.