Show-Command (Microsoft.PowerShell.Utility)

Show-Command

Modül:: Microsoft.PowerShell.Utility

PowerShell komut bilgilerini grafiksel bir pencerede görüntüler.

Sözdizimi

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

Tanım

Bu cmdlet yalnızca Windows platformunda mevcuttur.

Show-Command cmdlet'i, bir komut penceresinde PowerShell komutu oluşturmanıza olanak tanır. Komutu çalıştırmak veya komutun size geri dönmesini sağlamak için komut penceresinin özelliklerini kullanabilirsiniz.

Show-Command çok kullanışlı bir öğretme ve öğrenme aracıdır. Show-Command cmdlet'ler, işlevler, iş akışları ve CIM komutları dahil tüm komut türlerinde çalışır.

Parametreler olmadan, Show-Command, kurulu tüm modüllerdeki mevcut tüm komutları listeleyen bir komut penceresi görüntüler. Bir modüldeki komutları bulmak için Modüller açılır listesinden modülü seçin. Bir komut seçmek için komut adına tıklayın.

Komut penceresini kullanmak için, Adı kullanarak veya Komutlar listesinde komut adını tıklayarak bir komut seçin. Her parametre seti ayrı bir sekmede görüntülenir. Yıldız işaretleri zorunlu parametreleri gösterir. Bir parametreye değer girmek için değeri metin kutusuna yazın veya açılır kutudan değeri seçin. Bir anahtar parametresi eklemek için parametre onay kutusunu seçmek için tıklayın.

Hazır olduğunuzda, oluşturduğunuz komutu panoya kopyalamak için Kopyala'yı tıklayabilir veya komutu çalıştırmak için Çalıştır'ı tıklayabilirsiniz. Komutu PowerShell konsolu gibi ana programa döndürmek için PassThru parametresini de kullanabilirsiniz. Komut seçimini iptal etmek ve tüm komutları görüntüleyen görünüme geri dönmek için Ctrl tuşuna basın ve seçilen komutu tıklayın.

PowerShell Tümleşik Komut Dosyası Ortamı'nda (ISE), varsayılan olarak Show-Command penceresinin bir çeşidi görüntülenir. Bu komut penceresini kullanma hakkında bilgi için PowerShell ISE Yardımı konularına bakın.

Bu cmdlet PowerShell 7'de yeniden tanıtıldı.

Bu cmdlet bir kullanıcı arabirimi gerektirdiğinden Windows Server Core veya Windows Nano Server'da çalışmaz. Bu cmdlet yalnızca Windows Masaüstünü destekleyen Windows sistemlerinde kullanılabilir.

Örnekler

Örnek 1: Komutlar penceresini açın

Bu örnek, Show-Command penceresinin varsayılan görünümünü görüntüler. Komutlar penceresi, bilgisayarda yüklü olan tüm modüllerdeki tüm komutların bir listesini görüntüler.

Show-Command

Örnek 2: Komutlar penceresinde bir cmdlet açın

Bu örnek, Command penceresinde Invoke-Command cmdlet'ini görüntüler. Bu ekranı Invoke-Command komutlarını çalıştırmak için kullanabilirsiniz.

Show-Command -Name "Invoke-Command"

Örnek 3: Belirtilen parametrelerle bir cmdlet'i açın

Bu komut, Connect-PSSessioncmdlet'i için bir Show-Command penceresi açar.

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

Yükseklik ve Genişlik parametreleri komut penceresinin boyutunu belirtir. ErrorPopup parametresi hata komut penceresini görüntüler.

Çalıştır'ı tıkladığınızda, Connect-PSSession komutu, tıpkı komut satırına Connect-PSSession komutunu yazdığınızda olduğu gibi çalışır.

Örnek 4: Bir cmdlet için yeni varsayılan parametre değerlerini belirtme

Bu örnek, Height, Width ve ErrorPopup parametreleri için yeni varsayılan değerleri ayarlamak üzere $PSDefaultParameterValues otomatik değişkenini kullanır Show-Command cmdlet'inin.

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

Artık bir Show-Command komutunu çalıştırdığınızda, yeni varsayılanlar otomatik olarak uygulanır. Bu varsayılan değerleri her PowerShell oturumunda kullanmak için $PSDefaultParameterValues değişkenini PowerShell profilinize ekleyin. Daha fazla bilgi için bkz. about_Profiles ve about_Parameters_Default_Values.

Örnek 5: Çıktıyı ızgara görünümüne gönderme

Bu komut, Show-Command ve Out-GridView cmdlet'lerinin birlikte nasıl kullanılacağını gösterir.

Show-Command Get-ChildItem | Out-GridView

Komut, Get-ChildItem cmdlet'i için bir komut penceresi açmak üzere Show-Command cmdlet'ini kullanır. Çalıştır düğmesini tıkladığınızda Get-ChildItem komutu çalışır ve çıktı üretir. İşlem hattı operatörü ( | ), Get-ChildItem komutunun çıktısını, Get-ChildItem çıktısını görüntüleyen Out-GridView cmdlet'ine gönderir. etkileşimli bir pencerede.

Örnek 6: Komutlar penceresinde oluşturduğunuz bir komutu görüntüleyin

Bu örnek, Show-Command penceresinde oluşturduğunuz komutu gösterir. Komut, Show-Command sonuçlarını bir dizede döndüren PassThru parametresini kullanır.

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

Örneğin, Windows PowerShell olay günlüğündeki en yeni beş olayı alan bir Get-EventLog komutu oluşturmak için Show-Command penceresini kullanırsanız ve ardından Tamam, komut yukarıda gösterilen çıktıyı döndürür. Komut dizesini görüntülemek PowerShell'i öğrenmenize yardımcı olur.

Örnek 7: Bir komutu değişkene kaydetme

Bu örnek, Show-Command cmdlet'inin PassThru parametresini kullandığınızda elde ettiğiniz komut dizesinin nasıl çalıştırılacağını gösterir. Bu strateji, komutu görmenizi ve kullanmanızı sağlar.

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

İlk komut, Show-Command cmdlet'inin PassThru parametresini kullanır ve komutun sonuçlarını $C değişkenine kaydeder. Bu durumda, Windows PowerShell olay günlüğündeki en yeni beş olayı alan bir Get-EventLog komutu oluşturmak için Show-Command penceresini kullanırız. Tamam'ı tıkladığınızda, Show-Command, $C değişkenine kaydedilen komut dizesini döndürür.

Örnek 8: Bir komutun çıktısını bir değişkene kaydetme

Bu örnekte, bir komutun çıktısını bir değişkene kaydetmek için ErrorPopup parametresi kullanılır.

$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

ErrorPopup, hataları bir pencerede görüntülemenin yanı sıra, yeni bir komut oluşturmak yerine komut çıktısını geçerli komuta döndürür. Bu komutu çalıştırdığınızda Komutu Göster penceresi açılır. Parametre değerlerini ayarlamak için pencere özelliklerini kullanabilirsiniz. Komutu çalıştırmak için Komutu Göster penceresindeki Çalıştır düğmesini tıklayın.

Parametreler

-ErrorPopup

Cmdlet'in hataları komut satırında görüntülemenin yanı sıra bir açılır pencerede görüntülediğini belirtir. Varsayılan olarak, Show-Command penceresinde çalıştırılan bir komut bir hata oluşturduğunda, hata yalnızca komut satırında görüntülenir.

Ayrıca, komutu çalıştırdığınızda (Komutu Göster penceresindeki Çalıştır düğmesini kullanarak), ErrorPopup parametresi komut sonuçlarını şuraya döndürür: komutu çalıştırmak ve çıktısını yeni bir komuta döndürmek yerine geçerli komutu kullanın. Komut sonuçlarını bir değişkene kaydetmek için bu özelliği kullanabilirsiniz.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Height

Show-Command penceresinin yüksekliğini piksel cinsinden belirtir. 300 ile ekran çözünürlüğündeki piksel sayısı arasında bir değer girin. Değer, komut penceresini ekranda görüntüleyemeyecek kadar büyükse, Show-Command bir hata oluşturur. Varsayılan yükseklik 600 pikseldir. Ad parametresini içeren bir Show-Command komutu için varsayılan yükseklik 300 pikseldir.

Tip :: Çift
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Name

Belirtilen komut için bir komut penceresi görüntüler. Bir cmdlet'in, işlevin veya CIM komutunun adı gibi bir komutun adını girin. Bu parametreyi atlarsanız Show-Command, bilgisayarda yüklü olan tüm modüllerdeki tüm PowerShell komutlarını listeleyen bir komut penceresi görüntüler.

Tip :: String
Takma adlar:: CommandName
Konum:: 0
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-NoCommonParameter

Bu cmdlet'in komut ekranının Ortak Parametreler bölümünü atladığını belirtir. Varsayılan olarak Ortak Parametreler, komut penceresinin altındaki genişletilebilir bir bölümde görünür.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesneyi döndürür. Varsayılan olarak bu cmdlet herhangi bir çıktı oluşturmaz. Komut dizesini çalıştırmak için, onu kopyalayıp komut istemine yapıştırın veya bir değişkene kaydedin ve dizeyi değişkende çalıştırmak için Invoke-Expression cmdlet'ini kullanın.

Tip :: SwitchParameter
Konum:: Adlandırılmış
Varsayılan değer:: False
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

-Width

Show-Command penceresinin genişliğini piksel cinsinden belirtir. 300 ile ekran çözünürlüğündeki piksel sayısı arasında bir değer girin. Değer, komut penceresini ekranda görüntüleyemeyecek kadar büyükse, Show-Command bir hata oluşturur. Varsayılan genişlik 300 pikseldir.

Tip :: Çift
Konum:: Adlandırılmış
Varsayılan değer:: None
Gerekli:: False
Boru hattı girişini kabul edin:: False
Joker karakterleri kabul et:: False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar