Show-Command

  • Reference
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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ů zobrazí příkazové okno se Show-Command 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 použít příkazové okno, 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řipravení, 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 . K vrácení příkazu do hostitelského programu, jako je například konzola PowerShellu, můžete použít také parametr PassThru . 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 Show-Command okna. 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í Show-Command okna. V okně Příkazy se 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 příkazovémokně. Toto zobrazení můžete použít ke spuštění Invoke-Command příkazů.

Show-Command -Name "Invoke-Command"

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

Tento příkaz otevře Show-Command okno 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, Connect-PSSession příkaz se spustí stejně, jako kdybyste příkaz zadali 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á automatickou proměnnou $PSDefaultParameterValues k nastavení nových výchozích hodnot pro parametry Height, Width a ErrorPopup rutiny Show-Command .

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

Když teď spustíte Show-Command příkaz, použijí se nové výchozí hodnoty automaticky. Pokud chcete tyto výchozí hodnoty použít v každé relaci PowerShellu, přidejte proměnnou $PSDefaultParameterValues do profilu PowerShellu. 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-CommandOut-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 , Get-ChildItem příkaz se spustí a vygeneruje výstup. Operátor kanálu ( | ) odešle výstup Get-ChildItem příkazu do Out-GridView rutiny, který zobrazí Get-ChildItem výstup 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 Show-Command okně. Příkaz používá parametr PassThru , který vrací Show-Command výsledky v řetězci.

Show-Command -PassThru

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

Pokud například pomocí Show-Command okna vytvoříte Get-EventLog příkaz, 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žije parametr Show-Command PassThru rutiny a uloží výsledky příkazu do $C proměnné. V tomto případě pomocí Show-Command okna vytvoříme Get-EventLog příkaz, který získá pět nejnovějších událostí v protokolu událostí Windows PowerShellu. Po kliknutí na tlačítko OK Show-Commandvrátí příkazový řetězec, který je uložen v $C proměnné.

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ě vrátí ErrorPopup 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 Show-Command otevře okno. Pomocí funkcí okna můžete nastavit hodnoty parametrů. Pokud chcete příkaz spustit, klikněte v okně na tlačítko Spustit.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 Show-Command okně 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 Show-Command okně) vrátí parametr ErrorPopup výsledky příkazu do aktuálního příkazu místo spuštění příkazu a vrácení jeho výstupu do nového příkazu. Tuto funkci můžete použít k uložení výsledků příkazu do proměnné.

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

-Height

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

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, zobrazí se okno příkazového řádku se Show-Command seznamem všech příkazů PowerShellu ve všech modulech nainstalovaných v počítači.

Type:String
Aliases:CommandName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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é.

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

-Width

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

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.