Add-PSSnapin

  • Referensi
Modul:
Microsoft.PowerShell.Core

Menambahkan satu atau beberapa snap-in Windows PowerShell ke sesi saat ini.

Sintaks

Add-PSSnapin
   [-Name] <String[]>
   [-PassThru]
   [<CommonParameters>]

Deskripsi

Add-PSSnapin Cmdlet menambahkan snap-in Windows PowerShell terdaftar ke sesi saat ini. Setelah snap-in ditambahkan, Anda dapat menggunakan cmdlet dan penyedia yang didukung snap-in dalam sesi saat ini.

Untuk menambahkan snap-in ke semua sesi Windows PowerShell mendatang, tambahkan Add-PSSnapin perintah ke profil Windows PowerShell Anda. Untuk informasi selengkapnya, lihat about_Profiles.

Dimulai di Windows PowerShell 3.0, perintah inti yang disertakan dalam Windows PowerShell dibungkus dalam modul. Pengecualiannya adalah Microsoft.PowerShell.Core, yang merupakan snap-in (PSSnapin). Secara default, hanya snap-in Microsoft.PowerShell.Core yang ditambahkan ke sesi. Modul diimpor secara otomatis pada penggunaan pertama dan Anda dapat menggunakan cmdlet Import-Module untuk mengimpornya.

Contoh

Contoh 1: Menambahkan snap-in

PS C:\> Add-PSSnapIn -Name Microsoft.Exchange, Microsoft.Windows.AD

Perintah ini menambahkan snap-in Microsoft Exchange dan Direktori Aktif ke sesi saat ini.

Contoh 2: Tambahkan semua snap-in terdaftar

PS C:\> Get-PSSnapin -Registered | Add-PSSnapin -Passthru

Perintah ini menambahkan semua snap-in Windows PowerShell terdaftar ke sesi. Ini menggunakan cmdlet Get-PSSnapin dengan parameter Terdaftar untuk mendapatkan objek yang mewakili masing-masing snap-in terdaftar. Operator alur (|) meneruskan hasil ke Add-PSSnapin, yang menambahkannya ke sesi. Parameter PassThru mengembalikan objek yang mewakili setiap snap-in yang ditambahkan.

Contoh 3: Mendaftarkan snap-in dan menambahkannya

Perintah pertama mendapatkan snap-in yang telah ditambahkan ke sesi saat ini yang menyertakan snap-in yang diinstal dengan Windows PowerShell. Dalam contoh ini, ManagementFeatures tidak dikembalikan. Ini menunjukkan bahwa itu belum ditambahkan ke sesi.

Perintah kedua mendapatkan snap-in yang telah didaftarkan pada sistem Anda, yang mencakup yang telah ditambahkan ke sesi. Ini tidak termasuk snap-in yang diinstal dengan Windows PowerShell. Dalam hal ini, perintah tidak mengembalikan snap-in apa pun. Ini menunjukkan bahwa snapin ManagementFeatures belum terdaftar pada sistem.

Perintah ketiga membuat alias, installutil, untuk jalur alat InstallUtil di .NET Framework.

Perintah keempat menggunakan alat InstallUtil untuk mendaftarkan snap-in. Perintah menentukan jalur ManagementCmdlets.dll, nama file, atau nama modul snap-in.

Perintah kelima sama dengan perintah kedua. Kali ini, Anda menggunakannya untuk memverifikasi bahwa snap-in ManagementCmdlets terdaftar.

Perintah keenam menggunakan Add-PSSnapin cmdlet untuk menambahkan snap-in ManagementFeatures ke sesi. Ini menentukan nama snap-in, ManagementFeatures, bukan nama file.

Untuk memverifikasi bahwa snap-in ditambahkan ke sesi, perintah ketujuh menggunakan parameter Modul cmdlet Get-Command. Ini menampilkan item yang ditambahkan ke sesi oleh snap-in atau modul.

Anda juga dapat menggunakan properti PSSnapin dari objek yang Get-Command dikembalikan cmdlet untuk menemukan snap-in atau modul tempat cmdlet berasal. Perintah kedelapan menggunakan notasi titik untuk menemukan nilai properti PSSnapin dari cmdlet Set-Alias.

PS C:\> Get-PSSnapin
PS C:\> Get-PSSnapin -Registered
PS C:\> Set-Alias installutil $env:windir\Microsoft.NET\Framework\v2.0.50727\installutil.exe
PS C:\> installutil C:\Dev\Management\ManagementCmdlets.dll
PS C:\> Get-PSSnapin -Registered
PS C:\> add-pssnapin ManagementFeatures
PS C:\> Get-Command -Module ManagementFeatures
PS C:\> (Get-Command Set-Alias).pssnapin

Contoh ini menunjukkan proses mendaftarkan snap-in pada sistem Anda lalu menambahkannya ke sesi Anda. Ini menggunakan ManagementFeatures, snap-in fiktif yang diimplementasikan dalam file yang diberi nama ManagementCmdlets.dll.

Parameter

-Name

Menentukan nama snap-in. Ini adalah Nama, bukan AssemblyName atau ModuleName. Kartubebas diizinkan.

Untuk menemukan nama snap-in terdaftar pada sistem Anda, ketik Get-PSSnapin -Registered.

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

-PassThru

Menunjukkan bahwa cmdlet ini mengembalikan objek yang mewakili setiap snap-in yang ditambahkan. Secara default, cmdlet ini tidak menghasilkan output apa pun.

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

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

None or System.Management.Automation.PSSnapInInfo

Cmdlet ini mengembalikan objek PSSnapInInfo yang mewakili snap-in jika Anda menentukan parameter PassThru . Jika tidak, cmdlet ini tidak menghasilkan output apa pun.

Catatan

Windows PowerShell menyertakan alias berikut untuk Add-PSSnapin:

  • asnp

Dimulai di Windows PowerShell 3.0, perintah inti yang diinstal dengan Windows PowerShell dimas dalam modul. Di Windows PowerShell 2.0, dan dalam program host yang membuat sesi gaya lama di versi Windows PowerShell yang lebih baru, perintah inti dimas dalam snap-in (PSSnapins). Pengecualiannya adalah Microsoft.PowerShell.Core, yang selalu merupakan snap-in. Selain itu, sesi jarak jauh, seperti yang dimulai oleh cmdlet New-PSSession, adalah sesi gaya lama yang mencakup snap-in in inti.

Untuk informasi tentang metode CreateDefault2 yang membuat sesi gaya yang lebih baru dengan modul inti, lihat Metode CreateDefault2.

Untuk informasi selengkapnya tentang snap-in, lihat about_PSSnapins dan Cara Membuat Snap-in Windows PowerShell.

Add-PSSnapin menambahkan snap-in hanya ke sesi saat ini. Untuk menambahkan snap-in ke semua sesi Windows PowerShell, tambahkan ke profil Windows PowerShell Anda. Untuk informasi selengkapnya, lihat about_Profiles.

Anda dapat menambahkan snap-in apa pun yang telah didaftarkan menggunakan utilitas penginstalan Microsoft .NET Framework. Untuk informasi selengkapnya, lihat Cara Mendaftarkan Cmdlet, Penyedia, dan Aplikasi Host.

Untuk mendapatkan daftar snap-in yang terdaftar di komputer Anda, ketik Get-PSSnapin -Registered.

Sebelum menambahkan snap-in, Add-PSSnapin periksa versi snap-in untuk memverifikasi bahwa snap-in kompatibel dengan versi Windows PowerShell saat ini. Jika snap-in gagal dalam pemeriksaan versi, Windows PowerShell melaporkan kesalahan.