Show-Command
Menampilkan informasi perintah PowerShell di jendela grafis.
Sintaks
Default (Default)
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]
Deskripsi
Cmdlet ini hanya tersedia di platform Windows.
Cmdlet Show-Command memungkinkan Anda membuat perintah PowerShell di jendela perintah. Anda dapat menggunakan fitur jendela perintah untuk menjalankan perintah atau mengembalikan perintah kepada Anda.
Show-Command adalah alat pengajaran dan pembelajaran yang sangat berguna.
Show-Command berfungsi pada semua jenis perintah, termasuk cmdlet, fungsi, alur kerja, dan perintah CIM.
Tanpa parameter, Show-Command menampilkan jendela perintah yang mencantumkan semua perintah yang tersedia di semua modul yang diinstal. Untuk menemukan perintah dalam modul, pilih modul dari daftar drop-down Modul. Untuk memilih perintah, klik nama perintah.
Untuk menggunakan jendela perintah, pilih perintah, baik dengan menggunakan nama atau dengan mengklik nama perintah di daftar Perintah. Setiap set parameter ditampilkan pada tab terpisah. Tanda bintang menunjukkan parameter wajib. Untuk memasukkan nilai untuk parameter, ketik nilai dalam kotak teks atau pilih nilai dari kotak drop-down. Untuk menambahkan parameter pengalihan, klik untuk memilih kotak centang parameter.
Setelah siap, Anda dapat mengklik Salin untuk menyalin perintah yang telah Anda buat ke clipboard atau klik Jalankan untuk menjalankan perintah. Anda juga dapat menggunakan parameter PassThru
Di PowerShell Integrated Scripting Environment (ISE), variasi jendela Show-Command ditampilkan secara default. Untuk informasi tentang menggunakan jendela perintah ini, lihat topik Bantuan ISE PowerShell.
Cmdlet ini diperkenalkan kembali di PowerShell 7.
Karena cmdlet ini memerlukan antarmuka pengguna, cmdlet ini tidak berfungsi pada Windows Server Core atau Windows Nano Server. Cmdlet ini hanya tersedia pada sistem Windows yang mendukung Windows Desktop.
Contoh
Contoh 1: Buka jendela Perintah
Contoh ini menampilkan tampilan default jendela Show-Command. Jendela Perintah menampilkan daftar semua perintah di semua modul yang diinstal di komputer.
Show-Command
Contoh 2: Buka cmdlet di jendela Perintah
Contoh ini menampilkan cmdlet Invoke-Command di jendela Perintah . Anda dapat menggunakan tampilan ini untuk menjalankan perintah Invoke-Command.
Show-Command -Name "Invoke-Command"
Contoh 3: Buka cmdlet dengan parameter tertentu
Perintah ini membuka jendela Show-Command untuk cmdletConnect-PSSession.
Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup
Parameter Tinggi
Saat Anda mengklik Jalankan, perintah Connect-PSSession berjalan, seperti halnya jika Anda mengetik perintah Connect-PSSession di baris perintah.
Contoh 4: Tentukan nilai parameter default baru untuk cmdlet
Contoh ini menggunakan variabel otomatis
$PSDefaultParameterValues = @{
"Show-Command:Height" = 700
"Show-Command:Width" = 1000
"Show-Command:ErrorPopup" = $true
}
Sekarang saat Anda menjalankan perintah Show-Command, default baru diterapkan secara otomatis. Untuk menggunakan nilai default ini di setiap sesi PowerShell, tambahkan variabel $PSDefaultParameterValues ke profil PowerShell Anda. Untuk informasi selengkapnya, lihat tentang_Profil dan tentang_Nilai_Bawaan_Parameter.
Contoh 5: Menampilkan output dalam tampilan kisi
Perintah ini menunjukkan cara menggunakan cmdlet Show-Command dan Out-GridView bersama-sama.
Show-Command Get-ChildItem | Out-GridView
Perintah menggunakan cmdlet Show-Command untuk membuka jendela perintah untuk cmdletGet-ChildItem.
Saat Anda mengklik tombol Jalankan, perintah Get-ChildItem berjalan dan menghasilkan output. Operator alur ( | ) mengirimkan output perintah Get-ChildItem ke cmdlet Out-GridView, yang menampilkan output Get-ChildItem di jendela interaktif.
Contoh 6: Menampilkan perintah yang Anda buat di jendela Perintah
Contoh ini memperlihatkan perintah yang Anda buat di jendela Show-Command. Perintah menggunakan parameter PassThru, yang mengembalikan hasil Show-Command dalam string.
Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5
Misalnya, jika Anda menggunakan jendela Show-Command untuk membuat perintah Get-EventLog yang mendapatkan lima peristiwa terbaru di log peristiwa Windows PowerShell, lalu klik OK, perintah mengembalikan output yang ditunjukkan di atas. Menampilkan string perintah membantu Anda mempelajari PowerShell.
Contoh 7: Menyimpan perintah ke variabel
Contoh ini menunjukkan cara menjalankan string perintah yang Anda dapatkan saat menggunakan parameter PassThru cmdlet Show-Command. Strategi ini memungkinkan Anda melihat perintah dan menggunakannya.
$C = Show-Command -PassThru
$C
Invoke-Expression $C
Get-EventLog -LogName "PowerShell" -Newest 5
Index Time EntryType Source InstanceID Message
----- ---- --------- ------ ---------- -------
11520 Dec 16 16:37 Information Windows PowerShell 400 Engine state is changed from None to Available...
11519 Dec 16 16:37 Information Windows PowerShell 600 Provider "Variable" is Started. ...
11518 Dec 16 16:37 Information Windows PowerShell 600 Provider "Registry" is Started. ...
11517 Dec 16 16:37 Information Windows PowerShell 600 Provider "Function" is Started. ...
11516 Dec 16 16:37 Information Windows PowerShell 600 Provider "FileSystem" is Started. ...
Perintah pertama menggunakan parameter PassThru Show-Command untuk membuat perintah Get-EventLog yang mendapatkan lima peristiwa terbaru di log peristiwa Windows PowerShell. Saat Anda mengklik OK, Show-Command mengembalikan string perintah, yang disimpan dalam variabel $C.
Contoh 8: Simpan output perintah ke variabel
Contoh ini menggunakan parameter
$P = Show-Command Get-Process -ErrorPopup
$P
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
473 33 94096 112532 709 2.06 4492 powershell
Selain menampilkan kesalahan di jendela, ErrorPopup mengembalikan output perintah ke perintah saat ini, alih-alih membuat perintah baru. Saat Anda menjalankan perintah ini, jendela Show-Command terbuka. Anda dapat menggunakan fitur jendela untuk mengatur nilai parameter. Untuk menjalankan perintah, klik tombol Jalankan di jendela Show-Command.
Parameter
-ErrorPopup
Menunjukkan bahwa cmdlet menampilkan kesalahan di jendela pop-up, selain menampilkannya di baris perintah. Secara default, ketika perintah yang dijalankan di jendela Show-Command menghasilkan kesalahan, kesalahan hanya ditampilkan di baris perintah.
Selain itu, saat Anda menjalankan perintah (dengan menggunakan tombol Jalankan di jendela Show-Command), parameter ErrorPopup mengembalikan hasil perintah ke perintah saat ini, alih-alih menjalankan perintah dan mengembalikan outputnya ke perintah baru. Anda dapat menggunakan fitur ini untuk menyimpan hasil perintah dalam variabel.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Height
Menentukan tinggi jendela Show-Command dalam piksel. Masukkan nilai antara 300 dan jumlah piksel dalam resolusi layar. Jika nilai terlalu besar untuk menampilkan jendela perintah di layar, Show-Command menghasilkan kesalahan. Tinggi default adalah 600 piksel. Untuk perintah
Properti parameter
| Jenis: | Double |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Name
Menampilkan jendela perintah untuk perintah yang ditentukan. Masukkan nama satu perintah, seperti nama cmdlet, fungsi, atau perintah CIM. Jika Anda menghilangkan parameter ini, Show-Command menampilkan jendela perintah yang mencantumkan semua perintah PowerShell di semua modul yang diinstal di komputer.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | CommandName |
Set parameter
(All)
| Position: | 0 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-NoCommonParameter
Menunjukkan bahwa cmdlet ini menghilangkan bagian Parameter Umum dari tampilan perintah. Secara default, Parameter Umum muncul di bagian yang dapat diperluas di bagian bawah jendela perintah.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-PassThru
Mengembalikan objek yang mewakili item dengan mana Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun. Untuk menjalankan string perintah, salin dan tempelkan di prompt perintah atau simpan dalam variabel dan gunakan cmdlet Invoke-Expression untuk menjalankan string dalam variabel.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Width
Menentukan lebar jendela Show-Command dalam piksel. Masukkan nilai antara 300 dan jumlah piksel dalam resolusi layar. Jika nilai terlalu besar untuk menampilkan jendela perintah di layar, Show-Command menghasilkan kesalahan. Lebar defaultnya adalah 300 piksel.
Properti parameter
| Jenis: | Double |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
String
Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan string perintah.
Object
Saat Anda menggunakan parameter ErrorPopup, cmdlet ini mengembalikan output perintah (objek apa pun).
Catatan
PowerShell menyertakan alias berikut untuk Show-Command:
- Windows:
shcm
Cmdlet ini hanya tersedia di platform Windows.
Show-Command tidak berfungsi dalam sesi jarak jauh.