Delen via

Show-Command

  • Referentie
Module:
Microsoft.PowerShell.Utility

Geeft powerShell-opdrachtgegevens weer in een grafisch venster.

Syntaxis

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

Met de Show-Command-cmdlet kunt u een PowerShell-opdracht maken in een opdrachtvenster. U kunt de functies van het opdrachtvenster gebruiken om de opdracht uit te voeren of de opdracht naar u te laten retourneren.

Show-Command is een zeer nuttig leer- en leerhulpmiddel. Show-Command werkt op alle opdrachttypen, waaronder cmdlets, functies, werkstromen en CIM-opdrachten.

Zonder parameters geeft Show-Command een opdrachtvenster weer met alle beschikbare opdrachten in alle geïnstalleerde modules. Als u de opdrachten in een module wilt vinden, selecteert u de module in de vervolgkeuzelijst Modules. Als u een opdracht wilt selecteren, klikt u op de naam van de opdracht.

Als u het opdrachtvenster wilt gebruiken, selecteert u een opdracht met behulp van de naam of door te klikken op de opdrachtnaam in de opdrachten lijst. Elke parameterset wordt weergegeven op een afzonderlijk tabblad. Sterretjes geven de verplichte parameters aan. Als u waarden voor een parameter wilt invoeren, typt u de waarde in het tekstvak of selecteert u de waarde in de vervolgkeuzelijst. Als u een schakelparameter wilt toevoegen, klikt u om het selectievakje parameter in te schakelen.

Wanneer u klaar bent, kunt u op Kopiëren klikken om de opdracht die u hebt gemaakt naar het klembord te kopiëren of op uitvoeren om de opdracht uit te voeren. U kunt ook de parameter PassThru gebruiken om de opdracht te retourneren naar het hostprogramma, zoals de PowerShell-console. Als u de opdrachtselectie wilt annuleren en wilt terugkeren naar de weergave waarin alle opdrachten worden weergegeven, drukt u op Ctrl en klikt u op de geselecteerde opdracht.

In de Ise (Integrated Scripting Environment) van PowerShell wordt standaard een variatie van het venster Show-Command weergegeven. Zie de Help-onderwerpen van PowerShell ISE voor informatie over het gebruik van dit opdrachtvenster.

Deze cmdlet is opnieuw geïntroduceerd in PowerShell 7.

Omdat deze cmdlet een gebruikersinterface vereist, werkt deze niet op Windows Server Core of Windows Nano Server. Deze cmdlet is alleen beschikbaar op Windows-systemen die ondersteuning bieden voor het Windows-bureaublad.

Voorbeelden

Voorbeeld 1: Het venster Opdrachten openen

In dit voorbeeld wordt de standaardweergave van het venster Show-Command weergegeven. In het venster Opdrachten wordt een lijst weergegeven met alle opdrachten in alle modules die op de computer zijn geïnstalleerd.

Show-Command

Voorbeeld 2: Een cmdlet openen in het venster Opdrachten

In dit voorbeeld wordt de cmdlet Invoke-Command weergegeven in het venster Command. U kunt deze weergave gebruiken om Invoke-Command opdrachten uit te voeren.

Show-Command -Name "Invoke-Command"

Voorbeeld 3: Een cmdlet met opgegeven parameters openen

Met deze opdracht opent u een Show-Command venster voor deConnect-PSSessioncmdlet.

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

De parameters Height en Width geven de dimensie van het opdrachtvenster op. De parameter ErrorPopup geeft het venster foutopdracht weer.

Wanneer u op Uitvoerenklikt, wordt de opdracht Connect-PSSession uitgevoerd, net zoals wanneer u de Connect-PSSession opdracht op de opdrachtregel hebt getypt.

Voorbeeld 4: Nieuwe standaardparameterwaarden voor een cmdlet opgeven

In dit voorbeeld wordt de automatische variabele $PSDefaultParameterValues gebruikt om nieuwe standaardwaarden in te stellen voor de parameters Height, Widthen ErrorPopup parameters van de Show-Command-cmdlet.

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

Wanneer u nu een Show-Command opdracht uitvoert, worden de nieuwe standaardwaarden automatisch toegepast. Als u deze standaardwaarden in elke PowerShell-sessie wilt gebruiken, voegt u de $PSDefaultParameterValues variabele toe aan uw PowerShell-profiel. Zie about_Profiles en about_Parameters_Default_Valuesvoor meer informatie.

Voorbeeld 5: Uitvoer verzenden naar een rasterweergave

Deze opdracht laat zien hoe u de Show-Command en Out-GridView cmdlets samen kunt gebruiken.

Show-Command Get-ChildItem | Out-GridView

De opdracht gebruikt de Show-Command cmdlet om een opdrachtvenster voor deGet-ChildItemcmdlet te openen. Wanneer u op de knop uitvoeren klikt, wordt de opdracht Get-ChildItem uitgevoerd en wordt uitvoer gegenereerd. De pijplijnoperator ( | ) verzendt de uitvoer van de opdracht Get-ChildItem naar de Out-GridView-cmdlet, waarin de Get-ChildItem uitvoer in een interactief venster wordt weergegeven.

Voorbeeld 6: Een opdracht weergeven die u in het venster Opdrachten maakt

In dit voorbeeld ziet u de opdracht die u in het venster Show-Command hebt gemaakt. De opdracht maakt gebruik van de parameter PassThru, waarmee de Show-Command resulteert in een tekenreeks.

Show-Command -PassThru

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

Als u bijvoorbeeld het Show-Command-venster gebruikt om een Get-EventLog opdracht te maken waarmee de vijf nieuwste gebeurtenissen in het Windows PowerShell-gebeurtenislogboek worden opgevraagd en vervolgens op OK-klikt, retourneert de opdracht de bovenstaande uitvoer. Als u de opdrachtreeks bekijkt, leert u PowerShell.

Voorbeeld 7: Een opdracht opslaan in een variabele

In dit voorbeeld ziet u hoe u de opdrachtreeks uitvoert die u krijgt wanneer u de parameter PassThru van de Show-Command-cmdlet gebruikt. Met deze strategie kunt u de opdracht bekijken en gebruiken.

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

De eerste opdracht maakt gebruik van de parameter PassThru van de Show-Command cmdlet en slaat de resultaten van de opdracht op in de $C variabele. In dit geval gebruiken we het Show-Command-venster om een Get-EventLog opdracht te maken waarmee de vijf nieuwste gebeurtenissen in het Windows PowerShell-gebeurtenislogboek worden weergegeven. Wanneer u op OKklikt, retourneert Show-Command de opdrachtreeks, die wordt opgeslagen in de $C variabele.

Voorbeeld 8: De uitvoer van een opdracht opslaan in een variabele

In dit voorbeeld wordt de parameter ErrorPopup gebruikt om de uitvoer van een opdracht in een variabele op te slaan.

$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

Naast het weergeven van fouten in een venster, retourneert ErrorPopup opdrachtuitvoer naar de huidige opdracht, in plaats van een nieuwe opdracht te maken. Wanneer u deze opdracht uitvoert, wordt het venster Show-Command geopend. U kunt de vensterfuncties gebruiken om parameterwaarden in te stellen. Als u de opdracht wilt uitvoeren, klikt u op de knop uitvoeren in het venster Show-Command.

Parameters

-ErrorPopup

Geeft aan dat de cmdlet fouten weergeeft in een pop-upvenster, naast het weergeven ervan op de opdrachtregel. Wanneer een opdracht die in een Show-Command venster wordt uitgevoerd, standaard een fout genereert, wordt de fout alleen weergegeven op de opdrachtregel.

Wanneer u de opdracht uitvoert (met behulp van de knop Uitvoeren in het venster Show-Command), retourneert de parameter ErrorPopup de opdrachtresultaten naar de huidige opdracht, in plaats van de opdracht uit te voeren en de uitvoer terug te zetten naar een nieuwe opdracht. U kunt deze functie gebruiken om de opdrachtresultaten op te slaan in een variabele.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Height

Hiermee geeft u de hoogte van het Show-Command venster in pixels. Voer een waarde in tussen 300 en het aantal pixels in de schermresolutie. Als de waarde te groot is om het opdrachtvenster op het scherm weer te geven, genereert Show-Command een fout. De standaardhoogte is 600 pixels. Voor een Show-Command-opdracht die de parameter Name bevat, is de standaardhoogte 300 pixels.

Type:Double
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Geeft een opdrachtvenster weer voor de opgegeven opdracht. Voer de naam van één opdracht in, zoals de naam van een cmdlet, functie of CIM-opdracht. Als u deze parameter weglaat, geeft Show-Command een opdrachtvenster weer met alle PowerShell-opdrachten in alle modules die op de computer zijn geïnstalleerd.

Type:String
Aliassen:CommandName
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoCommonParameter

Geeft aan dat deze cmdlet de sectie Algemene parameters van de opdrachtweergave weglaat. Standaard worden de algemene parameters weergegeven in een uitvouwbare sectie onder aan het opdrachtvenster.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer. Als u de opdrachtreeks wilt uitvoeren, kopieert en plakt u deze bij de opdrachtprompt of slaat u deze op in een variabele en gebruikt u de Invoke-Expression-cmdlet om de tekenreeks in de variabele uit te voeren.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Width

Hiermee geeft u de breedte van het Show-Command venster in pixels. Voer een waarde in tussen 300 en het aantal pixels in de schermresolutie. Als de waarde te groot is om het opdrachtvenster op het scherm weer te geven, genereert Show-Command een fout. De standaardbreedte is 300 pixels.

Type:Double
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

String

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een opdrachtreeks.

Object

Wanneer u de parameter ErrorPopup gebruikt, retourneert deze cmdlet de opdrachtuitvoer (elk object).

Notities

PowerShell bevat de volgende aliassen voor Show-Command:

  • Ramen:
    • shcm

Deze cmdlet is alleen beschikbaar op Windows-platforms.

Show-Command werkt niet in externe sessies.