Bagikan melalui


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 untuk mengembalikan perintah ke program host, seperti konsol PowerShell. Untuk membatalkan pilihan perintah dan kembali ke tampilan yang menampilkan semua perintah, tekan Ctrl dan klik perintah yang dipilih.

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 dan menentukan dimensi jendela perintah. Parameter ErrorPopup menampilkan jendela perintah kesalahan.

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 untuk mengatur nilai default baru untukTinggi , Lebar, dan parameter ErrorPopup dari cmdlet .

$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 cmdlet dan menyimpan hasil perintah dalam variabel . Dalam hal ini, kita menggunakan jendela 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 ErrorPopup untuk menyimpan output perintah dalam variabel.

$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 yang menyertakan parameter Nama , tinggi 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

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