Show-Command

Başvuru

Modül:: Microsoft.PowerShell.Utility

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

Sözdizimi

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

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Show-Command cmdlet'i, komut penceresinde bir PowerShell komutu oluşturmanıza olanak tanır. Komutu çalıştırmak veya komutu 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, oluşturduğunuz komutu panoya kopyalamak için Kopyala'ya veya komutu çalıştırmak için çalıştır'a tıklayabilirsiniz. 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), varsayılan olarak Show-Command penceresinin bir varyasyonu 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, Show-Command penceresinin varsayılan görünümü 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 Invoke-Command cmdlet'ini görüntüler. Invoke-Command komutları çalıştırmak için bu ekranı kullanabilirsiniz.

Show-Command -Name "Invoke-Command"

Örnek 3: Belirtilen parametrelerle bir cmdlet açma

Bu komut,Connect-PSSessioncmdlet'i için Show-Command bir 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 komutu aynı komut satırına Connect-PSSession komutu yazdığınız gibi çalışır.

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

Bu örnekte, Height, Widthiçin yeni varsayılan değerler ayarlamak ve Show-Command cmdlet'in ErrorPopup parametrelerini için $PSDefaultParameterValues otomatik değişkeni kullanılır.

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

Artık bir Show-Command komutu ç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ı kılavuz 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, Show-Command cmdlet'ini kullanarakGet-ChildItemcmdlet'i için bir komut penceresi açar. Çalıştır düğmesine tıkladığınızda, Get-ChildItem komutu çalıştırılır ve çıkış oluşturur. İşlem hattı işleci ( | ), Get-ChildItem komutunun çıkışını Out-GridView cmdlet'ine gönderir ve bu da Get-ChildItem çıktısını etkileşimli bir pencerede görüntüler.

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

Bu örnekte, Show-Command penceresinde oluşturduğunuz komut gösterilir. komut, Show-Command sonuçlarını dize olarak 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ır ve ardından Tamam'e 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, Show-Command cmdlet'in PassThru parametresini kullandığınızda elde ettiğiniz komut dizesinin nasıl çalıştırıldığı gösterilir. Bu strateji komutunu 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, Show-Command cmdlet'in 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'a tıkladığınızda Show-Command$C değişkenine kaydedilen komut dizesini 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

Bir pencerede hataları görüntülemeye ek olarak, ErrorPopup yeni bir komut oluşturmak yerine geçerli komuta komut çıktısı döndürür. Bu komutu çalıştırdığınızda Show-Command penceresi açılır. Parametre değerlerini ayarlamak için pencere özelliklerini kullanabilirsiniz. Komutu çalıştırmak için Show-Command penceresinde Çalıştır düğmesine tıklayın.

Parametreler

-ErrorPopup

Cmdlet'in hataları komut satırında görüntülemeye ek olarak bir açılır pencerede görüntülediğini gösterir. Varsayılan olarak, Show-Command penceresinde ç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 (Show-Command penceresindeki Ç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.

Tür:	SwitchParameter
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Height

Show-Command penceresinin yüksekliğini piksel cinsinden belirtir. Ekran çözünürlüğünde 300 ile 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. Name parametresini içeren bir Show-Command komutu için varsayılan yükseklik 300 pikseldir.

Tür:	Double
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Diğer adlar:	CommandName
Position:	0
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-NoCommonParameter

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

Tür:	SwitchParameter
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz. Komut dizesini çalıştırmak için komut istemine kopyalayıp 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.

Tür:	SwitchParameter
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Width

Show-Command penceresinin genişliğini piksel cinsinden belirtir. Ekran çözünürlüğünde 300 ile 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.

Tür:	Double
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

String

PassThru parametresini kullandığınızda, bu cmdlet bir komut dizesi döndürür.

Object

ErrorPopup parametresini kullandığınızda, bu cmdlet komut çıkışını (herhangi bir nesne) döndürür.

Notlar

PowerShell, Show-Commandiçin aşağıdaki diğer adları içerir:

Windows:
- shcm

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

Show-Command uzak oturumlarda çalışmaz.

Aracılığıyla paylaş