Show-Command

  • Referentie
Module:
Microsoft.PowerShell.Utility

Geeft powerShell-opdrachtgegevens weer in een grafisch venster.

Syntax

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 Show-Command geeft u 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 op de opdrachtnaam in de lijst Opdrachten te klikken. 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 te kopiëren die u hebt gemaakt naar het klembord of op Uitvoeren klikken 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 PowerShell Integrated Scripting Environment (ISE) wordt standaard een variatie van het Show-Command venster 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 Show-Command venster 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 Invoke-Command cmdlet weergegeven in het opdrachtvenster . U kunt deze weergave gebruiken om opdrachten uit te voeren Invoke-Command .

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 Hoogte en Breedte geven de dimensie van het opdrachtvenster op. Met de parameter ErrorPopup wordt het venster foutopdracht weergegeven.

Wanneer u op Uitvoeren klikt, wordt de Connect-PSSession opdracht 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 $PSDefaultParameterValues automatische variabele gebruikt om nieuwe standaardwaarden in te stellen voor de parameters Height, Width en ErrorPopup 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_Values voor 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 Get-ChildItem opdracht uitgevoerd en wordt uitvoer gegenereerd. De pijplijnoperator ( | ) verzendt de uitvoer van de Get-ChildItem opdracht naar de Out-GridView cmdlet, die de Get-ChildItem uitvoer in een interactief venster weergeeft.

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

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

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 die de vijf nieuwste gebeurtenissen in het Windows PowerShell-gebeurtenislogboek ophaalt 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 die de vijf nieuwste gebeurtenissen in het Windows PowerShell-gebeurtenislogboek ophaalt. Wanneer u op OK klikt, Show-Command wordt de opdrachtreeks geretourneerd die in de $C variabele wordt opgeslagen.

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 Show-Command venster 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 Show-Command venster.

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 Show-Command venster), retourneert de parameter ErrorPopup de opdrachtresultaten naar de huidige opdracht, in plaats van de opdracht uit te voeren en de uitvoer terug te geven 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
Required:False
Accept pipeline input:False
Accept wildcard characters: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, Show-Command wordt er een fout gegenereerd. De standaardhoogte is 600 pixels. Voor een Show-Command opdracht met de parameter Name is de standaardhoogte 300 pixels.

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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, Show-Command wordt een opdrachtvenster weergegeven met alle PowerShell-opdrachten in alle modules die op de computer zijn geïnstalleerd.

Type:String
Aliases:CommandName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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, Show-Command wordt er een fout gegenereerd. De standaardbreedte is 300 pixels.

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

  • Windows:
    • shcm

Deze cmdlet is alleen beschikbaar op Windows-platforms.

Show-Command werkt niet in externe sessies.