Show-Command

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee maakt u Windows PowerShell-opdrachten in een grafisch opdrachtvenster.

Syntaxis

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

Description

Met de cmdlet Show-Command kunt u een Windows 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 terug te sturen naar het hostprogramma, zoals de Windows 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 Windows PowerShell Integrated Scripting Environment (ISE) wordt standaard een variatie van het venster Show-Command weergegeven. Zie de Help-onderwerpen van Windows PowerShell ISE voor informatie over het gebruik van dit opdrachtvenster.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: Het venster Opdrachten openen

PS C:\> Show-Command

Met deze opdracht 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.

Voorbeeld 2: Een cmdlet openen in het venster Opdrachten

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

Met deze opdracht wordt de Invoke-Command cmdlet weergegeven in het venster Show-Command. U kunt de invoke-command weergeven om invoke-command opdrachten uit te voeren.

Voorbeeld 3: Een cmdlet met opgegeven parameters openen

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

Met deze opdracht opent u een venster Show-Command voor de Connect-PSSession-cmdlet. Hierbij worden de parameters Height en Width gebruikt om de dimensie van het opdrachtvenster en de parameter ErrorPopup weer te geven om het venster foutopdracht weer te geven.

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

Voorbeeld 4: Nieuwe standaardparameterwaarden voor een cmdlet opgeven

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

Met deze opdracht wordt de automatische variabele $PSDefaultParameterValues gebruikt om nieuwe standaardwaarden in te stellen voor de Height, Widthen ErrorPopup parameters van de Show-Command cmdlet. Wanneer u nu een opdracht Show-Command uitvoert, worden de nieuwe standaardwaarden automatisch toegepast.

Als u deze standaardwaarden in elke Windows PowerShell-sessie wilt gebruiken, voegt u de $PSDefaultParameterValues variabele toe aan uw Windows PowerShell-profiel. Zie about_Profiles en about_Parameters_Default_Valuesvoor meer informatie.

Voorbeeld 5: Uitvoer verzenden naar een rasterweergave

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

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

De opdracht gebruikt de cmdlet Show-Command om een opdrachtvenster voor de Get-ChildItem cmdlet 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

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

Met deze opdracht wordt de opdracht weergegeven die u hebt gemaakt in het venster Show-Command. De opdracht maakt gebruik van de parameter PassThru, die de Show-Command retourneert resulteert in een tekenreeks.

Als u bijvoorbeeld het venster Show-Command 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 volgende uitvoer.

Als u de opdrachtreeks bekijkt, kunt u Windows PowerShell leren.

Voorbeeld 7: Een opdracht opslaan in een variabele

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

Deze opdracht laat zien 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.

De eerste opdracht maakt gebruik van de parameter PassThru- van de cmdlet Show-Command. De resultaten van de opdracht worden opgeslagen in de variabele $C.

Met de opdracht wordt een venster Show-Command geopend. In dit geval gebruiken we het venster Show-Command 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 is opgeslagen in de $C variabele.

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

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

Deze opdrachten gebruiken de parameter ErrorPopup van de cmdlet Show-Command om de uitvoer van een opdracht in een variabele op te slaan.

Met de eerste opdracht wordt de cmdlet Show-Command uitgevoerd met de parameter ErrorPopup. 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 wordt uitgevoerd in een venster Show-Command 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:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Height

Hiermee geeft u de hoogte van het venster Show-Command 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 een fout genereert. De standaardhoogte is 600 pixels. Voor een opdracht weergeven met de parameter Name 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, werkstroom of CIM-opdracht. Als u deze parameter weglaat, geeft Show-Command een opdrachtvenster weer met alle Windows 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:	None
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:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Width

Hiermee geeft u de breedte van het venster Show-Command 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 een fout genereert. De standaardbreedte is 300 pixels.

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

Invoerwaarden

None

U kunt invoer niet doorsluisen naar show-command.

Uitvoerwaarden

System.String, System.Object

Wanneer u de parameter PassThru gebruikt, retourneert Show-Command een opdrachtreeks. Wanneer u de parameter ErrorPopup gebruikt, retourneert Show-Command de opdrachtuitvoer (elk object). Anders genereert Show-Command- geen uitvoer.

Notities

Show-Command werkt niet in externe sessies.

Delen via