Show-Command

Reference

Modul:: Microsoft.PowerShell.Utility

Zobrazí informace o příkazu PowerShellu v grafickém okně.

Syntaxe

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Show-Command umožňuje vytvořit příkaz PowerShellu v příkazovém okně. Pomocí funkcí příkazového okna můžete příkaz spustit nebo ho nechat vrátit vám.

Show-Command je velmi užitečný výukový a výukový nástroj. Show-Command funguje na všech typech příkazů, včetně rutin, funkcí, pracovních postupů a příkazů CIM.

Bez parametrů Show-Command zobrazí příkazové okno se seznamem všech dostupných příkazů ve všech nainstalovaných modulech. Pokud chcete najít příkazy v modulu, vyberte ho z rozevíracího seznamu Moduly. Pokud chcete vybrat příkaz, klikněte na název příkazu.

Pokud chcete příkazové okno použít, vyberte příkaz, a to buď pomocí názvu, nebo kliknutím na název příkazu v seznamu Příkazy. Každá sada parametrů se zobrazí na samostatné kartě. Hvězdičky označují povinné parametry. Pokud chcete zadat hodnoty parametru, zadejte hodnotu do textového pole nebo vyberte hodnotu z rozevíracího seznamu. Chcete-li přidat parametr přepínače, kliknutím zaškrtněte políčko parametru.

Až budete připraveni, můžete kliknutím na Kopírovat zkopírovat příkaz, který jste vytvořili do schránky, nebo kliknutím na Spustit příkaz spustit. Můžete také použít parametr PassThru k vrácení příkazu do hostitelského programu, jako je například konzola PowerShellu. Pokud chcete výběr příkazu zrušit a vrátit se do zobrazení, ve které se zobrazí všechny příkazy, stiskněte klávesu Ctrl a klikněte na vybraný příkaz.

V integrovaném skriptovacím prostředí PowerShellu (ISE) se ve výchozím nastavení zobrazí varianta okna Show-Command. Informace o používání tohoto příkazového okna najdete v tématech nápovědy k prostředí PowerShell ISE.

Tato rutina byla znovu vyvolána v PowerShellu 7.

Vzhledem k tomu, že tato rutina vyžaduje uživatelské rozhraní, nefunguje na Windows Serveru Core nebo Windows Nano Serveru. Tato rutina je dostupná jenom v systémech Windows, které podporují Windows Desktop.

Příklady

Příklad 1: Otevření okna Příkazy

Tento příklad zobrazí výchozí zobrazení okna Show-Command. Okno Příkazy zobrazí seznam všech příkazů ve všech modulech nainstalovaných v počítači.

Show-Command

Příklad 2: Otevření rutiny v okně Příkazy

Tento příklad zobrazí rutinu Invoke-Command v okně Command. Toto zobrazení můžete použít ke spuštění příkazů Invoke-Command.

Show-Command -Name "Invoke-Command"

Příklad 3: Otevření rutiny se zadanými parametry

Tento příkaz otevře okno Show-Command pro rutinuConnect-PSSession.

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

Parametry Height a Width určují rozměr příkazového okna. Parametr ErrorPopup zobrazí okno příkazového řádku chyby.

Když kliknete na Spustit, spustí se příkaz Connect-PSSession stejně, jako kdybyste zadali příkaz Connect-PSSession na příkazový řádek.

Příklad 4: Zadání nových výchozích hodnot parametrů pro rutinu

Tento příklad používá $PSDefaultParameterValues automatickou proměnnou k nastavení nových výchozích hodnot pro Height, Widtha ErrorPopup parametry rutiny Show-Command.

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

Když teď spustíte příkaz Show-Command, použijí se nové výchozí hodnoty automaticky. Pokud chcete tyto výchozí hodnoty použít v každé relaci PowerShellu, přidejte do profilu PowerShellu $PSDefaultParameterValues proměnnou. Další informace najdete v tématu about_Profiles a about_Parameters_Default_Values.

Příklad 5: Odeslání výstupu do zobrazení mřížky

Tento příkaz ukazuje, jak společně používat rutiny Show-Command a Out-GridView.

Show-Command Get-ChildItem | Out-GridView

Příkaz používá rutinu Show-Command k otevření příkazového okna pro rutinuGet-ChildItem. Když kliknete na tlačítko Spustit, spustí se příkaz Get-ChildItem a vygeneruje výstup. Operátor kanálu ( | ) odešle výstup příkazu Get-ChildItem do rutiny Out-GridView, která zobrazí výstup Get-ChildItem v interaktivním okně.

Příklad 6: Zobrazení příkazu, který vytvoříte v okně Příkazy

Tento příklad ukazuje příkaz, který jste vytvořili v okně Show-Command. Příkaz používá parametr PassThru, který vrátí Show-Command výsledek řetězce.

Show-Command -PassThru

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

Pokud například pomocí okna Show-Command vytvoříte příkaz Get-EventLog, který získá pět nejnovějších událostí v protokolu událostí Windows PowerShellu a potom kliknete na OK, příkaz vrátí výstup uvedený výše. Zobrazení příkazového řetězce vám pomůže seznámit se s PowerShellem.

Příklad 7: Uložení příkazu do proměnné

Tento příklad ukazuje, jak spustit řetězec příkazu, který získáte při použití parametru PassThru rutiny Show-Command. Tato strategie umožňuje zobrazit příkaz a použít ho.

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

První příkaz používá parametr PassThru rutiny Show-Command a uloží výsledky příkazu do proměnné $C. V tomto případě pomocí okna Show-Command vytvoříme příkaz Get-EventLog, který získá pět nejnovějších událostí v protokolu událostí Windows PowerShellu. Když kliknete na OK, Show-Command vrátí příkazový řetězec, který je uložen v proměnné $C.

Příklad 8: Uložení výstupu příkazu do proměnné

Tento příklad používá parametr ErrorPopup k uložení výstupu příkazu do proměnné.

$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

Kromě zobrazení chyb v okně ErrorPopup vrací výstup příkazu do aktuálního příkazu místo vytvoření nového příkazu. Po spuštění tohoto příkazu se otevře okno Show-Command. Pomocí funkcí okna můžete nastavit hodnoty parametrů. Příkaz spustíte kliknutím na tlačítko Spustit v okně Show-Command.

Parametry

-ErrorPopup

Označuje, že rutina zobrazuje chyby v automaticky otevíraných oknech, kromě jejich zobrazení na příkazovém řádku. Pokud příkaz spuštěný v okně Show-Command ve výchozím nastavení vygeneruje chybu, zobrazí se tato chyba pouze na příkazovém řádku.

Při spuštění příkazu (pomocí tlačítka Spustit v okně Show-Command) vrátí parametr ErrorPopup výsledky příkazu do aktuálního příkazu, nikoli spuštění příkazu a vrácení výstupu do nového příkazu. Tuto funkci můžete použít k uložení výsledků příkazu do proměnné.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Height

Určuje výšku okna Show-Command v pixelech. Zadejte hodnotu mezi 300 a počtem pixelů v rozlišení obrazovky. Pokud je hodnota pro zobrazení příkazového okna na obrazovce příliš velká, Show-Command vygeneruje chybu. Výchozí výška je 600 pixelů. U Show-Command příkazu, který obsahuje parametr Name, je výchozí výška 300 pixelů.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Zobrazí příkazové okno pro zadaný příkaz. Zadejte název jednoho příkazu, například název rutiny, funkce nebo příkazu CIM. Pokud tento parametr vynecháte, Show-Command zobrazí příkazové okno se seznamem všech příkazů PowerShellu ve všech modulech nainstalovaných v počítači.

Typ:	String
Aliasy:	CommandName
Position:	0
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-NoCommonParameter

Označuje, že tato rutina vynechá část Společné parametry zobrazení příkazu. Ve výchozím nastavení se společné parametry zobrazí v rozbalitelné části v dolní části příkazového okna.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup. Pokud chcete spustit příkazový řetězec, zkopírujte ho a vložte do příkazového řádku nebo ho uložte do proměnné a pomocí rutiny Invoke-Expression spusťte řetězec v proměnné.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Width

Určuje šířku okna Show-Command v pixelech. Zadejte hodnotu mezi 300 a počtem pixelů v rozlišení obrazovky. Pokud je hodnota pro zobrazení příkazového okna na obrazovce příliš velká, Show-Command vygeneruje chybu. Výchozí šířka je 300 pixelů.

Typ:	Double
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

String

Pokud použijete parametr PassThru, vrátí tato rutina řetězec příkazu.

Object

Pokud použijete parametr ErrorPopup, vrátí tato rutina výstup příkazu (jakýkoli objekt).

Poznámky

PowerShell obsahuje následující aliasy pro Show-Command:

Windows:
- shcm

Tato rutina je dostupná jenom na platformách Windows.

Show-Command nefunguje ve vzdálených relacích.

Sdílet prostřednictvím