Show-Command
Vytvoří příkazy Windows PowerShellu v grafickém příkazovém okně.
Syntax
Default (Výchozí)
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]
Description
Rutina Show-Command umožňuje vytvořit příkaz Prostředí Windows PowerShell 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. Parametr PassThru můžete také použít 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 zobrazí všechny příkazy, stiskněte klávesu Ctrl a klikněte na vybraný příkaz.
V integrovaném skriptovacím prostředí windows PowerShellu (ISE) se ve výchozím nastavení zobrazí varianta okna Show-Command. Informace o použití tohoto příkazového okna naleznete v tématech nápovědy k Integrované skriptovací prostředí (ISE) v prostředí Windows PowerShell.
Tato rutina byla zavedena ve Windows PowerShellu 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, které jsou v počítači nainstalovány.
Příklad 2: Otevření rutiny v okně Příkazy
PS C:\> Show-Command -Name "Invoke-Command"
Tento příkaz otevře rutinu Invoke-Command v okně Show-Command. Ke spouštění příkazů můžete použít zobrazení 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. Pomocí parametrů Height a Width určuje rozměr příkazového okna a parametr ErrorPopup k zobrazení příkazového okna.
Když kliknete na Spustit, spustí se příkaz Connect-PSSession stejně, jako kdybyste zadali příkaz Connect-PSSession příkazového řádku.
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á $PSDefaultParameterValues automatickou proměnnou k nastavení nových výchozích hodnot pro Height, Widtha ErrorPopup parametry rutiny Show-Command. Když teď spustíte příkaz Show-Command, použijí se nové výchozí hodnoty automaticky.
Pokud chcete tyto výchozí hodnoty používat v každé relaci Windows PowerShell, přidejte do svého profilu Windows PowerShell proměnnou $PSDefaultParameterValues. Další informace naleznete v části 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, 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
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ý vrací výsledky příkazu Show-Command do řetězce.
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í následující výstup.
Zobrazení příkazového řetězce vám pomůže seznámit se s Prostředím 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 . Výsledky příkazu uloží do proměnné $C.
Příkaz otevře okno Show-Command . V tomto případě použijeme okno Show-Command k vytvoření Get-EventLog příkazu, který získá pět nejnovějších událostí v protokolu událostí Windows PowerShell. Když kliknete na tlačítko OK, příkaz Show-Command vrátí řetězec příkazu, který je uložen v 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ě ErrorPopup vrací výstup příkazu do aktuálního příkazu místo vytvoření nového příkazu.
Když spustíte tento příkaz, otevře se 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 se ve výchozím nastavení v okně Show-Command vygeneruje chyba, zobrazí se tato chyba pouze na příkazovém řádku.
Také při spuštění příkazu (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í výstupu do nového příkazu. Tuto funkci můžete použít k uložení výsledků příkazu do proměnné.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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á, aby se na obrazovce zobrazilo příkazové okno, Zobrazit příkaz vygeneruje chybu. Výchozí výška je 600 pixelů. U příkazu Show-Command, který obsahuje parametr Name, je výchozí výška 300 pixelů.
Vlastnosti parametru
| Typ: | Double |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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, Show-Command zobrazí příkazové okno se seznamem všech příkazů Prostředí Windows PowerShell ve všech modulech nainstalovaných v počítači.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | CommandName |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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é.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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á, aby se na obrazovce zobrazilo příkazové okno, Zobrazit příkaz vygeneruje chybu. Výchozí šířka je 300 pixelů.
Vlastnosti parametru
| Typ: | Double |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Vstup do příkazu Show-Command nelze převést .
Výstupy
System.String, System.Object
Při použití parametru PassThruShow-Command vrátí řetězec příkazu. Při použití ErrorPopup parametr, Show-Command vrátí výstup příkazu (libovolný objekt). Jinak příkazu Show-Command negeneruje žádný výstup.
Poznámky
- show-command nefunguje ve vzdálených relacích.