about_PSSnapins

  • Artikel

Deskripsi singkat

Menjelaskan snap-in Windows PowerShell dan memperlihatkan cara menggunakan dan mengelolanya.

Deskripsi panjang

Snap-in Windows PowerShell adalah rakitan Microsoft .NET Framework yang dapat berisi penyedia dan cmdlet Windows PowerShell. Windows PowerShell menyertakan sekumpulan snap-in dasar, tetapi Anda dapat memperluas daya dan nilai Windows PowerShell dengan menambahkan snap-in yang berisi penyedia dan cmdlet yang Anda buat atau dapatkan dari orang lain.

Saat Anda menambahkan snap-in, cmdlet dan penyedia yang dikandungnya segera tersedia untuk digunakan dalam sesi saat ini, tetapi perubahan hanya memengaruhi sesi saat ini.

Untuk menambahkan snap-in ke semua sesi mendatang, simpan di profil Windows PowerShell Anda. Anda juga dapat menggunakan Export-Console cmdlet untuk menyimpan nama snap-in ke file konsol lalu menggunakan konfigurasi tersimpan tersebut di sesi mendatang.

Dimulai di Windows PowerShell 3.0, cmdlet yang dikirim dengan PowerShell dimas dalam modul. Pengecualiannya adalah Microsoft.PowerShell.Core, yang merupakan satu-satunya snap-in yang tersisa. Snap-in Microsoft.PowerShell.Core dimuat di setiap sesi secara default. Modul yang tersisa dimuat secara otomatis pada penggunaan pertama. Untuk informasi selengkapnya, lihat about_Modules.

Menemukan snap-in

Untuk mendapatkan daftar snap-in Windows PowerShell di komputer Anda, ketik:

Get-PSSnapin

Untuk mendapatkan snap-in untuk setiap penyedia Windows PowerShell, ketik:

Get-PSProvider | Format-List name, pssnapin

Untuk mendapatkan semua snap-in terdaftar di sistem Anda atau untuk memverifikasi bahwa snap-in terdaftar, ketik:

Get-PSSnapin -registered

Untuk mendapatkan daftar cmdlet dalam snap-in Windows PowerShell, ketik:

Get-Command -Module <snap-in_name>

Menginstal snap-in

Snap-in bawaan terdaftar dalam sistem dan ditambahkan ke sesi default saat Anda memulai Windows PowerShell. Namun, Anda harus mendaftarkan snap-in yang Anda buat atau peroleh dari orang lain lalu menambahkan snap-in ke sesi Anda.

Menambahkan snap-in ke sesi saat ini

Untuk menambahkan snap-in terdaftar ke sesi saat ini, gunakan Add-PsSnapin cmdlet . Misalnya, untuk menambahkan snap-in Microsoft SQL Server ke sesi, ketik:

Add-PSSnapin sql

Setelah perintah selesai, penyedia dan cmdlet dalam snap-in tersedia dalam sesi. Namun, mereka hanya tersedia dalam sesi saat ini kecuali Anda menyimpannya.

Menyimpan snap-in

Untuk menggunakan snap-in di sesi Windows PowerShell mendatang, tambahkan perintah ke Add-PsSnapin profil Windows PowerShell Anda. Atau, ekspor nama snap-in ke file konsol.

Jika Anda menambahkan perintah ke Add-PSSnapin profil Anda, perintah tersebut tersedia di semua sesi Windows PowerShell di masa mendatang. Jika Anda mengekspor nama snap-in dalam sesi Anda, Anda dapat menggunakan file ekspor hanya saat Anda memerlukan snap-in.

Untuk menambahkan perintah ke Add-PsSnapin profil Windows PowerShell Anda, buka profil Anda, tempel atau ketik perintah, lalu simpan profil. Untuk informasi selengkapnya, lihat about_Profiles.

Untuk menyimpan snap-in dari sesi dalam file konsol (.psc1), gunakan Export-Console cmdlet . Misalnya, untuk menyimpan snap-in dalam konfigurasi sesi saat ini ke NewConsole.psc1 file di direktori saat ini, ketik:

Export-Console NewConsole

Untuk informasi selengkapnya, lihat Ekspor-Konsol.

Buka Windows PowerShell menggunakan file konsol

Untuk menggunakan file konsol yang menyertakan snap-in, mulai Windows PowerShell (powershell.exe) dari prompt perintah di cmd.exe atau di sesi Windows PowerShell lainnya. Gunakan parameter PsConsoleFile untuk menentukan file konsol yang menyertakan snap-in. Misalnya, perintah berikut memulai Windows PowerShell dengan NewConsole.psc1 file konsol:

PowerShell.exe -psconsolefile NewConsole.psc1

Penyedia dan cmdlet dalam snap-in sekarang tersedia untuk digunakan dalam sesi.

Menghapus snap-in

Untuk menghapus snap-in Windows PowerShell dari sesi saat ini, gunakan Remove-PsSnapin cmdlet . Misalnya, untuk menghapus snap-in SQL Server dari sesi saat ini, ketik:

Remove-PSSnapin sql

Cmdlet ini menghapus snap-in dari sesi. Snap-in masih dimuat, tetapi penyedia dan cmdlet yang didukungnya tidak lagi tersedia.

Mencatat peristiwa snap-in

Dimulai di Windows PowerShell 3.0, Anda dapat merekam peristiwa eksekusi untuk cmdlet di modul Windows PowerShell dan snap-in dengan mengatur properti LogPipelineExecutionDetails modul dan snap-in ke $true. Untuk informasi selengkapnya, lihat about_EventLogs.

Lihat juga