Show-Command

Modül:: Microsoft.PowerShell.Utility Module

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

Sözdizimi

Default EnterprisePublishing

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, Invoke-Command penceresinde 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,Show-Commandcmdlet'i için Connect-PSSession 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, $PSDefaultParameterValues, Widthiçin yeni varsayılan değerler ayarlamak ve cmdlet'in ErrorPopup parametrelerini için Show-Command 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, sonuçlarını dize olarak döndüren Show-Command 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 Show-Command komutu oluşturmak için Get-EventLog 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, cmdlet'in Show-Command 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, cmdlet'in Show-Command 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 Show-Command komutu oluşturmak için Get-EventLog 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 penceresinde Show-Command 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 ( penceresindeki 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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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. Show-Command parametresini içeren bir komutu için varsayılan yükseklik 300 pikseldir.

Parametre özellikleri

Tür:	Double
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	CommandName

Parametre kümeleri

(All)

Position:	0
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Double
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

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.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

Show-Command

Sözdizimi

Default EnterprisePublishing

Description

Örnekler

Örnek 1: Komutlar penceresini açma

Örnek 2: Komutlar penceresinde bir cmdlet açma

Örnek 3: Belirtilen parametrelerle bir cmdlet açma

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

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

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

Örnek 7: Komutu değişkene kaydetme

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

Parametreler

-ErrorPopup

Parametre özellikleri

Parametre kümeleri

-Height

Parametre özellikleri

Parametre kümeleri

-Name

Parametre özellikleri

Parametre kümeleri

-NoCommonParameter

Parametre özellikleri

Parametre kümeleri

-PassThru

Parametre özellikleri

Parametre kümeleri

-Width

Parametre özellikleri

Parametre kümeleri

CommonParameters

Girişler

None

Çıkışlar

None

String

Object

Notlar

Geri Bildirim