about_PSSnapins
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.
