Show-Command

Referensi

Modul:: Microsoft.PowerShell.Utility

Menampilkan informasi perintah PowerShell di jendela grafis.

Sintaks

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

Show-Command Cmdlet 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 bekerja 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 Lingkungan Skrip Terintegrasi (ISE) PowerShell, variasi Show-Command jendela 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 Invoke-Command cmdlet di jendela Perintah . Anda dapat menggunakan tampilan ini untuk menjalankan Invoke-Command perintah.

Show-Command -Name "Invoke-Command"

Contoh 3: Buka cmdlet dengan parameter tertentu

Perintah ini membuka Show-Command jendela untukConnect-PSSessioncmdlet.

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Parameter Tinggi dan Lebar menentukan dimensi jendela perintah. Parameter ErrorPopup menampilkan jendela perintah kesalahan.

Saat Anda mengklik Jalankan, Connect-PSSession perintah berjalan, seperti halnya Connect-PSSession jika Anda mengetik perintah di baris perintah.

Contoh 4: Tentukan nilai parameter default baru untuk cmdlet

Contoh ini menggunakan $PSDefaultParameterValues variabel otomatis untuk mengatur nilai default baru untuk parameter Tinggi, Lebar, dan ErrorPopup cmdlet Show-Command .

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $True
}

Sekarang saat Anda menjalankan Show-Command perintah, default baru diterapkan secara otomatis. Untuk menggunakan nilai default ini di setiap sesi PowerShell, tambahkan variabel ke $PSDefaultParameterValues profil PowerShell Anda. Untuk informasi selengkapnya, lihat about_Profiles dan about_Parameters_Default_Values.

Contoh 5: Mengirim output ke tampilan kisi

Perintah ini menunjukkan cara menggunakan Show-Command cmdlet dan Out-GridView bersama-sama.

Show-Command Get-ChildItem | Out-GridView

Perintah menggunakan Show-Command cmdlet untuk membuka jendela perintah untukGet-ChildItemcmdlet. Saat Anda mengklik tombol Jalankan , Get-ChildItem perintah akan berjalan dan menghasilkan output. Operator alur ( | ) mengirimkan output Get-ChildItem perintah ke Out-GridView cmdlet, yang menampilkan Get-ChildItem output di jendela interaktif.

Contoh 6: Menampilkan perintah yang Anda buat di jendela Perintah

Contoh ini memperlihatkan perintah yang Anda buat di Show-Command jendela. 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 Show-Command jendela untuk membuat Get-EventLog perintah 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 dari Show-Command cmdlet dan menyimpan hasil perintah dalam $C variabel. Dalam hal ini, kita menggunakan Show-Command jendela untuk membuat Get-EventLog perintah yang mendapatkan lima peristiwa terbaru di log peristiwa Windows PowerShell. Saat Anda mengklik OK, Show-Command mengembalikan string perintah, yang disimpan dalam $C variabel.

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, Show-Command jendela akan 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 Show-Command jendela menghasilkan kesalahan, kesalahan hanya ditampilkan di baris perintah.

Selain itu, saat Anda menjalankan perintah (dengan menggunakan tombol Jalankan di Show-Command jendela), 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.

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

-Height

Menentukan tinggi Show-Command jendela 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. Show-Command Untuk perintah yang menyertakan parameter Nama, tinggi defaultnya adalah 300 piksel.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-PassThru

Mengembalikan objek yang mewakili item tempat 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 Invoke-Expression cmdlet untuk menjalankan string dalam variabel.

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

-Width

Menentukan lebar Show-Command jendela 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.

Type:	Double
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

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.