Menginstal SDK Windows PowerShell

Berlaku Untuk: Windows PowerShell 2.0, Windows PowerShell 3.0

Topik berikut menjelaskan cara menginstal PowerShell SDK pada versi Windows yang berbeda.

Menginstal Windows PowerShell 3.0 SDK untuk Windows 8 dan Windows Server 2012

Windows PowerShell 3.0 secara otomatis diinstal dengan Windows 8 dan Windows Server 2012. Selain itu, Anda dapat mengunduh dan menginstal rakitan referensi untuk Windows PowerShell 3.0 sebagai bagian dari Windows 8 SDK. Rakitan ini memungkinkan Anda menulis cmdlet, penyedia, dan program host untuk Windows PowerShell 3.0. Saat Anda menginstal Windows SDK untuk Windows 8, rakitan Windows PowerShell secara otomatis diinstal di folder rakitan referensi, di \Program Files (x86)\Reference Assemblies\Microsoft\WindowsPowerShell\3.0. Untuk informasi selengkapnya, lihat situs unduhan Windows 8 SDK. Sampel kode Windows PowerShell juga tersedia di powershell-sdk-samples repositori.

Komponen Referensi

Rakitan referensi diinstal di lokasi berikut secara default: C:\Program Files\Reference Assemblies\Microsoft\WindowsPowerShell\V1.0.

Nota

Kode yang dikompilasi terhadap rakitan Windows PowerShell 2.0 tidak dapat dimuat ke dalam penginstalan Windows PowerShell 1.0. Namun, kode yang dikompilasi terhadap rakitan Windows PowerShell 1.0 dapat dimuat ke dalam penginstalan Windows PowerShell 2.0.

Contoh-contoh

Sampel kode diinstal di lokasi berikut secara default: C:\Program Files\Microsoft SDKs\Windows\v7.0\Samples\sysmgmt\WindowsPowerShell\. Bagian berikut memberikan deskripsi singkat tentang apa yang dilakukan setiap sampel.

Sampel cmdlet

• GetProcessSample01 - Menunjukkan cara menulis cmdlet sederhana yang mendapatkan semua proses di komputer lokal.
• GetProcessSample02 - Menunjukkan cara menambahkan parameter ke cmdlet. Cmdlet mengambil satu atau beberapa nama proses dan mengembalikan proses yang cocok.
• GetProcessSample03 - Menunjukkan cara menambahkan parameter yang menerima input dari alur.
• GetProcessSample04 - Menunjukkan cara menangani kesalahan yang tidak mengakhiri.
• GetProcessSample05 - Menampilkan cara menampilkan daftar proses yang ditentukan.
• PilihObject - Memperlihatkan cara menulis filter untuk memilih hanya objek tertentu.
• SelectString - Memperlihatkan cara mencari file untuk pola tertentu.
• StopProcessSample01 - Menunjukkan cara menerapkan parameter PassThru, dan cara meminta umpan balik pengguna dengan panggilan ke metode ShouldProcess dan ShouldContinue. Pengguna menentukan parameter PassThru saat mereka ingin memaksa cmdlet mengembalikan objek,
• StopProcessSample02 - Menunjukkan cara menghentikan proses tertentu.
• StopProcessSample03 - Menunjukkan cara mendeklarasikan alias untuk parameter dan cara mendukung wildcard.
• StopProcessSample04 - Menunjukkan cara mendeklarasikan set parameter, objek yang diambil cmdlet sebagai input, dan cara menentukan parameter default yang diatur untuk digunakan.

Sampel jarak jauh

• RemoteRunspace01 - Memperlihatkan cara membuat runspace jarak jauh yang digunakan untuk membuat koneksi jarak jauh.
• RemoteRunspacePool01 - Menunjukkan cara membuat kumpulan runspace jarak jauh dan cara menjalankan beberapa perintah secara bersamaan dengan menggunakan kumpulan ini.
• Serialisasi01 - Menunjukkan cara melihat kelas .NET yang ada dan memastikan bahwa informasi dari properti publik yang dipilih dari kelas ini dipertahankan di seluruh serialisasi/deserialisasi.
• Serialisasi02 - Menunjukkan cara melihat kelas .NET yang ada dan memastikan bahwa informasi dari instans kelas ini dipertahankan di seluruh serialisasi/deserialisasi ketika informasi tidak tersedia di properti publik kelas.
• Serialisasi03 - Menunjukkan cara melihat kelas .NET yang ada dan memastikan bahwa instans kelas ini dan kelas turunan dideserialisasi (direhidrasi) ke dalam objek .NET langsung.

Sampel peristiwa

• Event01 - Menunjukkan cara membuat cmdlet untuk pendaftaran peristiwa dengan berasal dari ObjectEventRegistrationBase.
• Event02 - Memperlihatkan cara menunjukkan cara menerima pemberitahuan peristiwa Windows PowerShell yang dihasilkan di komputer jarak jauh. Ini menggunakan peristiwa PSEventReceived yang diekspos melalui kelas Runspace.

Menghosting sampel aplikasi

• Runspace01 - Memperlihatkan cara menggunakan kelas PowerShell untuk menjalankan cmdlet Get-Process secara sinkron. Cmdlet Get-Process mengembalikan objek Proses untuk setiap proses yang berjalan di komputer lokal.
• Runspace02 - Memperlihatkan cara menggunakan kelas PowerShell untuk menjalankan cmdlet Get-Process dan Sort-Object secara sinkron. Cmdlet Get-Process mengembalikan objek Proses untuk setiap proses yang berjalan di komputer lokal, dan Sort-Object mengurutkan objek berdasarkan properti Id mereka. Hasil perintah ini ditampilkan dengan menggunakan kontrol DataGridView.
• Runspace03 - Memperlihatkan cara menggunakan kelas PowerShell untuk menjalankan skrip secara sinkron, dan cara menangani kesalahan yang tidak mengakhiri. Skrip menerima daftar nama proses lalu mengambil proses tersebut. Hasil skrip, termasuk kesalahan yang tidak mengakhiri yang dihasilkan saat menjalankan skrip, ditampilkan di jendela konsol.
• Runspace04 - Memperlihatkan cara menggunakan kelas PowerShell untuk menjalankan perintah, dan cara menangkap kesalahan penghentian yang dilemparkan saat menjalankan perintah. Dua perintah dijalankan, dan perintah terakhir diteruskan argumen parameter yang tidak valid. Akibatnya, tidak ada objek yang dikembalikan dan kesalahan penghentian dilemparkan.
• Runspace05 - Memperlihatkan cara menambahkan snap-in ke objek InitialSessionState sehingga cmdlet snap-in tersedia saat runspace dibuka. Snap-in menyediakan cmdlet Get-Proc (ditentukan oleh Sampel GetProcessSample01) yang dijalankan secara sinkron menggunakan objek PowerShell.
• Runspace06 - Menunjukkan cara menambahkan modul ke objek InitialSessionState sehingga modul dimuat saat runspace dibuka. Modul ini menyediakan cmdlet Get-Proc (ditentukan oleh Sampel GetProcessSample02) yang dijalankan secara sinkron menggunakan objek PowerShell.
• Runspace07 - Memperlihatkan cara membuat runspace, lalu menggunakan runspace tersebut untuk menjalankan dua cmdlet secara sinkron menggunakan objek PowerShell.
• Runspace08 - Memperlihatkan cara menambahkan perintah dan argumen ke alur objek PowerShell dan cara menjalankan perintah secara sinkron.
• Runspace09 - Memperlihatkan cara menambahkan skrip ke alur objek PowerShell dan cara menjalankan skrip secara asinkron. Peristiwa digunakan untuk menangani output skrip.
• Runspace10 - Memperlihatkan cara membuat status sesi awal default, cara menambahkan cmdlet ke InitialSessionState, cara membuat runspace yang menggunakan status sesi awal, dan cara menjalankan perintah menggunakan objek PowerShell.
• Runspace11 - Menunjukkan cara menggunakan kelas ProxyCommand untuk membuat perintah proksi yang memanggil cmdlet yang ada, tetapi membatasi kumpulan parameter yang tersedia. Perintah proksi kemudian ditambahkan ke status sesi awal yang digunakan untuk membuat runspace yang dibatasi. Ini berarti bahwa pengguna dapat mengakses fungsionalitas cmdlet hanya melalui perintah proksi.
• PowerShell01 - Memperlihatkan cara membuat runspace yang dibatasi menggunakan objek InitialSessionState.
• PowerShell02 - Memperlihatkan cara menggunakan kumpulan runspace untuk menjalankan beberapa perintah secara bersamaan.

Sampel host

• Host01 - Menunjukkan cara menerapkan aplikasi host yang menggunakan host kustom. Dalam sampel ini, runspace dibuat yang menggunakan host kustom, lalu API PowerShell digunakan untuk menjalankan skrip yang memanggil exit. Aplikasi host kemudian melihat output skrip dan mencetak hasilnya.
• Host02 - Menunjukkan cara menulis aplikasi host yang menggunakan runtime Windows PowerShell bersama dengan implementasi host kustom. Aplikasi host mengatur budaya host ke Bahasa Jerman, menjalankan cmdlet Get-Process dan menampilkan hasilnya seperti yang Anda lihat dengan menggunakan pwrsh.exe, lalu mencetak data dan waktu saat ini dalam bahasa Jerman.
• Host03 - Menunjukkan cara membuat aplikasi host berbasis konsol interaktif yang membaca perintah dari baris perintah, menjalankan perintah, lalu menampilkan hasilnya ke konsol.
• Host04 - Menunjukkan cara membangun aplikasi host berbasis konsol interaktif yang membaca perintah dari baris perintah, menjalankan perintah, lalu menampilkan hasilnya ke konsol. Aplikasi host ini juga mendukung menampilkan perintah yang memungkinkan pengguna menentukan beberapa pilihan.
• Host05 - Menunjukkan cara membuat aplikasi host berbasis konsol interaktif yang membaca perintah dari baris perintah, menjalankan perintah, lalu menampilkan hasilnya ke konsol. Aplikasi host ini juga mendukung panggilan ke komputer jarak jauh dengan menggunakan cmdlet Enter-PSSession dan Exit-PSSession.
• Host06 - Menunjukkan cara membangun aplikasi host berbasis konsol interaktif yang membaca perintah dari baris perintah, menjalankan perintah, lalu menampilkan hasilnya ke konsol. Selain itu, sampel ini menggunakan API Tokenizer untuk menentukan warna teks yang dimasukkan oleh pengguna.

Sampel penyedia

• AccessDBProviderSample01 - Menunjukkan cara mendeklarasikan kelas penyedia yang berasal langsung dari kelas CmdletProvider. Ini termasuk di sini hanya untuk kelengkapan.

• AccessDBProviderSample02 - Memperlihatkan cara menimpa metode NewDrive dan RemoveDrive untuk mendukung panggilan ke cmdlet New-PSDrive dan Remove-PSDrive. Kelas penyedia dalam sampel ini berasal dari kelas DriveCmdletProvider.

• AccessDBProviderSample03 - Menunjukkan cara menimpa metode GetItem dan SetItem untuk mendukung panggilan ke cmdlet Get-Item dan Set-Item. Kelas penyedia dalam sampel ini berasal dari kelas ItemCmdletProvider.

• AccessDBProviderSample04 - Menunjukkan cara menimpa metode kontainer untuk mendukung panggilan ke cmdlet Copy-Item, Get-ChildItem, New-Item, dan Remove-Item. Metode ini harus diimplementasikan ketika penyimpanan data berisi item yang merupakan kontainer. Kontainer adalah sekelompok item turunan di bawah item induk umum. Kelas penyedia dalam sampel ini berasal dari kelas ItemCmdletProvider.

• AccessDBProviderSample05 - Menunjukkan cara menimpa metode kontainer untuk mendukung panggilan ke cmdlet Move-Item dan Join-Path. Metode ini harus diimplementasikan ketika pengguna perlu memindahkan item dalam kontainer dan jika penyimpanan data berisi kontainer berlapis. Kelas penyedia dalam sampel ini berasal dari kelas NavigationCmdletProvider.

• AccessDBProviderSample06 - Memperlihatkan cara menimpa metode konten untuk mendukung panggilan ke cmdlet Clear-Content, Get-Content, dan Set-Content. Metode ini harus diimplementasikan ketika pengguna perlu mengelola konten item di penyimpanan data. Kelas penyedia dalam sampel ini berasal dari kelas NavigationCmdletProvider, dan mengimplementasikan antarmuka IContentCmdletProvider.