Show-Command

Reference

Modul:: Microsoft.PowerShell.Utility

Vytvoří příkazy Windows PowerShell v grafickém příkazovém okně.

Syntax

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

Description

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

Show-Command je velmi užitečný výukový a výukový nástroj. Příkaz Show-Command funguje u všech typů 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. Příkazy v modulu najdete tak, že ho vyberete z rozevíracího seznamu Moduly. Pokud chcete vybrat příkaz, klikněte na jeho název.

Pokud chcete příkazové okno použít, vyberte příkaz 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. Pokud chcete přidat parametr přepínače, zaškrtněte políčko parametru kliknutím.

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

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

Tato rutina byla zavedena v Windows PowerShell 3.0.

Příklady

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

PS C:\> Show-Command

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

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

PS C:\> Show-Command -Name "Invoke-Command"

Tento příkaz otevře Invoke-Command zobrazení rutiny v okně Show-Command . Pomocí zobrazení Invoke-Command můžete spouštět příkazy Invoke-Command .

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

PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Tento příkaz otevře okno Show-Command pro rutinu Connect-PSSession. Používá parametry Height (Výška ) a Width (Šířka ) k určení rozměru příkazového okna a parametr ErrorPopup k zobrazení okna chybového příkazu.

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

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

PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}

Tento příkaz používá automatickou proměnnou $PSDefaultParameterValues k nastavení nových výchozích hodnot parametrů Height, Width a ErrorPopup rutiny Show-Command . Když teď spustíte příkaz Show-Command , nové výchozí hodnoty se použijí automaticky.

Pokud chcete tyto výchozí hodnoty použít v každé relaci Windows PowerShell, přidejte do profilu Windows PowerShell proměnnou $PSDefaultParameterValues. Další informace najdete v tématu about_Profiles a about_Parameters_Default_Values.

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

PS C:\> Show-Command Get-ChildItem | Out-GridView

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

Příkaz používá rutinu Show-Command k otevření příkazového okna pro rutinu Get-ChildItem. Když kliknete na tlačítko Spustit , příkaz Get-ChildItem se spustí 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

PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5

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

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 PowerShell, a potom kliknete na OK, vrátí příkaz následující výstup.

Zobrazení příkazového řetězce vám pomůže zjistit, Windows PowerShell.

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

PS C:\> $C = Show-Command -PassThru

This command displays the command string in the $C variable.
PS C:\> $C
Get-EventLog -LogName "Windows PowerShell" -Newest 5

These commands use the Invoke-Expression cmdlet to run the string in the $C variable. The first command uses the full cmdlet name. The second command uses the "iex" alias for the **Invoke-Expression** cmdlet. These commands are equivalent and you can use them interchangeably.The output shows the five newest events in the Windows PowerShell event log.
PS C:\> Invoke-Expression $C

PS C:\> iex $C
   Index Time          EntryType   Source                 InstanceID Message
   ----- ----          ---------   ------                 ---------- -------
   11520 Dec 16 16:37  Information PowerShell                    400 Engine state is changed from None to Available....
   11519 Dec 16 16:37  Information PowerShell                    600 Provider "Variable" is Started. ...
   11518 Dec 16 16:37  Information PowerShell                    600 Provider "Registry" is Started. ...
   11517 Dec 16 16:37  Information PowerShell                    600 Provider "Function" is Started. ...
   11516 Dec 16 16:37  Information PowerShell                    600 Provider "FileSystem" is Started. ...

Tento příkaz 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.

První příkaz používá parametr PassThru rutiny Show-Command . Uloží výsledky příkazu do proměnné $C.

Příkaz otevře okno Show-Command . 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 PowerShell. Když kliknete na OK, funkce Show-Command vrátí řetězec příkazu, který se uloží do proměnné $C.

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

PS C:\> $P = Show-Command Get-Process -ErrorPopup

The second command displays the value in the $P variable.
PS C:\> $P
Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName

-------  ------    -----      ----- -----   ------     -- -----------

    473      33    94096     112532   709     2.06   4492 powershell

Tyto příkazy používají parametr ErrorPopup rutiny Show-Command k uložení výstupu příkazu do proměnné.

První příkaz spustí rutinu Show-Command s parametrem ErrorPopup . Kromě zobrazení chyb v okně vrátí ErrorPopup výstup příkazu aktuálnímu příkazu místo vytvoření nového příkazu.

Po spuštění tohoto příkazu se otevře okno Show-Command . Funkce okna můžete použít k nastavení hodnot 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 a navíc je zobrazuje na příkazovém řádku. Pokud příkaz spuštěný v okně Show-Command ve výchozím nastavení vygeneruje chybu, zobrazí se chyba pouze na příkazovém řádku.

Navíc platí, že když spustíte příkaz (pomocí tlačítka Spustit v okně Show-Command ), vrátí parametr ErrorPopup výsledky příkazu aktuálnímu 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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 příliš velká pro zobrazení příkazového okna na obrazovce, funkce Show-Command vygeneruje chybu. Výchozí výška je 600 pixelů. Pro příkaz Show-Command , 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, pracovního postupu nebo příkazu CIM. Pokud tento parametr vynecháte, příkaz Show-Command zobrazí příkazové okno se seznamem všech Windows PowerShell příkazů 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:	None
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 řetězec příkazu, zkopírujte ho a vložte ho na příkazový řádek 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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 příliš velká pro zobrazení příkazového okna na obrazovce, funkce 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

Vstup nelze vložit do kanálu show-command.

Výstupy

System.String, System.Object

Při použití parametru PassThru vrátí funkce Show-Command řetězec příkazu. Při použití parametru ErrorPopup vrátí Show-Command výstup příkazu (libovolný objekt). V opačném případě show-command negeneruje žádný výstup.

Poznámky

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

Sdílet prostřednictvím