Show-Command

Başvuru

Modül:: Microsoft.PowerShell.Utility

PowerShell komut bilgilerini grafik pencerede görüntüler.

Syntax

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

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

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

Parametreler olmadan, Show-Command tüm yüklü modüllerdeki tüm kullanılabilir komutları listeleyen bir komut penceresi görüntüler. Modüldeki komutları bulmak için Modüller açılan 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ına tıklayarak bir komut seçin. Her parametre kümesi ayrı bir sekmede görüntülenir. Yıldız işareti zorunlu parametreleri gösterir. Parametrenin değerlerini girmek için, değeri metin kutusuna yazın veya açılan kutudan değeri seçin. Switch parametresi eklemek için, parametre onay kutusunu tıklayarak seçin.

Hazır olduğunuzda Kopyala'ya tıklayarak oluşturduğunuz komutu panoya kopyalayabilir veya çalıştır'a tıklayarak komutu çalıştırabilirsiniz. Komutu PowerShell konsolu gibi konak programına 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 dönmek için Ctrl tuşuna basın ve seçili komuta tıklayın.

PowerShell Tümleşik Betik Ortamı'nda (ISE), pencerenin bir varyasyonu Show-Command varsayılan olarak 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ği için Windows Server Core veya Windows Nano Server üzerinde çalışmaz. Bu cmdlet yalnızca Windows Masaüstü'nü destekleyen Windows sistemlerinde kullanılabilir.

Örnekler

Örnek 1: Komutlar penceresini açma

Bu örnekte pencerenin varsayılan görünümü Show-Command görüntülenir. Komutlar penceresinde, bilgisayarda yüklü olan tüm modüllerdeki tüm komutların listesi görüntülenir.

Show-Command

Örnek 2: Komutlar penceresinde bir cmdlet açma

Bu örnek Komut penceresinde cmdlet'ini görüntülerInvoke-Command. Komutları çalıştırmak Invoke-Command için bu ekranı kullanabilirsiniz.

Show-Command -Name "Invoke-Command"

Örnek 3: Belirtilen parametrelerle bir cmdlet açma

Bu komut, cmdlet içinConnect-PSSessionbir Show-Command pencere açar.

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

Height ve Width parametreleri komut penceresinin boyutunu belirtir. ErrorPopup parametresi hata komut penceresini görüntüler.

Çalıştır'a tıkladığınızda, Connect-PSSession komut aynı komut satırına Connect-PSSession yazdığınız gibi çalışır.

Örnek 4: Cmdlet için yeni varsayılan parametre değerleri belirtme

Bu örnekte cmdlet'in $PSDefaultParameterValuesHeight, Width ve ErrorPopup parametreleri Show-Command için yeni varsayılan değerler ayarlamak için otomatik değişken kullanılır.

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

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

Örnek 5: Çıkışı kılavuz görünümüne gönderme

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

Show-Command Get-ChildItem | Out-GridView

komut cmdlet'ini Show-Command kullanarak cmdlet içinGet-ChildItembir komut penceresi açar. Çalıştır düğmesine tıkladığınızda komut Get-ChildItem çalıştırılır ve çıkış oluşturur. İşlem hattı işleci ( | ) komutun Get-ChildItem çıkışını cmdlet'ine Out-GridView gönderir ve bu komut çıktıyı Get-ChildItem etkileşimli bir pencerede görüntüler.

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

Bu örnekte, pencerede oluşturduğunuz Show-Command komut gösterilir. Komutu, sonuçları bir dizede döndüren Show-CommandPassThru parametresini kullanır.

Show-Command -PassThru

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

Örneğin, pencereyi kullanarak Show-Command Windows PowerShell olay günlüğündeki en yeni beş olayı alan bir Get-EventLog komut oluşturur ve ardından Tamam'a tıklarsanız, komut yukarıda gösterilen çıkışı döndürür. Komut dizesini görüntülemek PowerShell'i öğrenmenize yardımcı olur.

Örnek 7: Komutu değişkene kaydetme

Bu örnekte, cmdlet'in PassThru parametresini kullandığınızda elde ettiğiniz komut dizesinin Show-Command nasıl çalıştırıldığı gösterilmektedir. Bu strateji komutu görmenize ve kullanmanıza olanak tanır.

$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, cmdlet'in Show-CommandPassThru parametresini kullanır ve komutun sonuçlarını değişkene $C kaydeder. Bu durumda, Windows PowerShell olay günlüğündeki en yeni beş olayı alan bir Get-EventLog komut oluşturmak için penceresini kullanırızShow-Command. Tamam'a tıkladığınızda, Show-Command değişkene kaydedilen komut dizesini $C döndürür.

Örnek 8: Komutun çıkışını bir değişkene kaydetme

Bu örnekte, bir komutun çıkışı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, bir pencerede hata görüntülemeye ek olarak, yeni bir komut oluşturmak yerine geçerli komuta komut çıkışı döndürür. Bu komutu çalıştırdığınızda Show-Command pencere açılır. Parametre değerlerini ayarlamak için pencere özelliklerini kullanabilirsiniz. Komutu çalıştırmak için penceredeki Çalıştır düğmesine Show-Command tıklayın.

Parametreler

-ErrorPopup

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

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

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

-Height

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

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

-Name

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

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoCommonParameter

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

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

-PassThru

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

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

-Width

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

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

Girişler

None

Girişi öğesine Show-Commandyöneltemezsiniz.

Çıkışlar

None, System.String, System.Object

PassThru parametresini kullandığınızda bir Show-Command komut dizesi döndürür. ErrorPopup parametresini kullandığınızda, Show-Command komut çıkışını (herhangi bir nesne) döndürür. Aksi takdirde, Show-Command herhangi bir çıkış oluşturmaz.

Notlar

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.

Show-Command uzak oturumlarda çalışmaz.

Aracılığıyla paylaş