Show-Command

Referens

Modul:: Microsoft.PowerShell.Utility

Skapar Windows PowerShell-kommandon i ett grafiskt kommandofönster.

Syntax

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

Description

Med cmdleten Show-Command kan du skapa ett Windows PowerShell-kommando i ett kommandofönster. Du kan använda funktionerna i kommandofönstret för att köra kommandot eller låta det returnera kommandot till dig.

Show-Command är ett mycket användbart undervisnings- och inlärningsverktyg. Show-Command fungerar på alla kommandotyper, inklusive cmdletar, funktioner, arbetsflöden och CIM-kommandon.

Utan parametrar visar Show-Command ett kommandofönster som visar alla tillgängliga kommandon i alla installerade moduler. Om du vill hitta kommandona i en modul väljer du modulen i listrutan Moduler. Om du vill välja ett kommando klickar du på kommandonamnet.

Om du vill använda kommandofönstret väljer du ett kommando, antingen med hjälp av namnet eller genom att klicka på kommandonamnet i listan Kommandon. Varje parameteruppsättning visas på en separat flik. Asterisker anger de obligatoriska parametrarna. Om du vill ange värden för en parameter skriver du värdet i textrutan eller väljer värdet i listrutan. Om du vill lägga till en växelparameter klickar du för att markera kryssrutan parameter.

När du är klar kan du klicka på Kopiera för att kopiera kommandot som du har skapat till Urklipp eller klicka på Kör för att köra kommandot. Du kan också använda parametern PassThru för att returnera kommandot till värdprogrammet, till exempel Windows PowerShell-konsolen. Om du vill avbryta kommandomarkeringen och återgå till vyn som visar alla kommandon trycker du på Ctrl och klickar på det valda kommandot.

I Windows PowerShell Integrated Scripting Environment (ISE) visas en variant av fönstret Show-Command som standard. Information om hur du använder det här kommandofönstret finns i hjälpavsnitten för Windows PowerShell ISE.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Öppna fönstret Kommandon

PS C:\> Show-Command

Det här kommandot visar standardvyn för fönstret Show-Command. Fönstret Kommandon visar en lista över alla kommandon i alla moduler som är installerade på datorn.

Exempel 2: Öppna en cmdlet i fönstret Kommandon

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

Det här kommandot öppnar cmdleten Invoke-Command i fönstret Visa kommando. Du kan använda Invoke-Command display för att köra Invoke-Command-kommandon.

Exempel 3: Öppna en cmdlet med angivna parametrar

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

Det här kommandot öppnar ett Visa kommando- fönster för cmdleten Connect-PSSession. Den använder parametrarna Height och Width för att ange dimensionen för kommandofönstret och parametern ErrorPopup för att visa kommandofönstret för felet.

När du klickar på Körkörs kommandot Connect-PSSession, precis som om du skrev kommandot Connect-PSSession på kommandoraden.

Exempel 4: Ange nya standardparametervärden för en cmdlet

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

Det här kommandot använder den automatiska variabeln $PSDefaultParameterValues för att ange nya standardvärden för parametrarna Height, Widthoch ErrorPopup för cmdleten Show-Command. Nu när du kör ett Kommandot Show-Command tillämpas de nya standardvärdena automatiskt.

Om du vill använda dessa standardvärden i varje Windows PowerShell-session lägger du till variabeln $PSDefaultParameterValues i din Windows PowerShell-profil. Mer information finns i about_Profiles och about_Parameters_Default_Values.

Exempel 5: Skicka utdata till en rutnätsvy

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

Det här kommandot visar hur du använder cmdletarna Show-Command och Out-GridView.

Kommandot använder cmdleten Show-Command för att öppna ett kommandofönster för cmdleten Get-ChildItem. När du klickar på knappen Kör körs kommandot Get-ChildItem och genererar utdata. Pipelineoperatorn ( | ) skickar utdata från kommandot Get-ChildItem till cmdleten Out-GridView, som visar Get-ChildItem utdata i ett interaktivt fönster.

Exempel 6: Visa ett kommando som du skapar i fönstret Kommandon

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

Det här kommandot visar kommandot som du skapade i fönstret Show-Command. Kommandot använder parametern PassThru, som returnerar Show-Command resulterar i en sträng.

Om du till exempel använder fönstret Show-Command för att skapa ett Get-EventLog kommando som hämtar de fem senaste händelserna i Windows PowerShell-händelseloggen och sedan klickar på OKreturnerar kommandot följande utdata.

Om du visar kommandosträngen kan du lära dig Windows PowerShell.

Exempel 7: Spara ett kommando i en variabel

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

Det här kommandot visar hur du kör kommandosträngen som du får när du använder parametern PassThru i cmdleten Show-Command. Med den här strategin kan du se kommandot och använda det.

Det första kommandot använder parametern PassThru i cmdleten Show-Command. Det sparar resultatet av kommandot i variabeln $C.

Kommandot öppnar ett fönstret Show-Command. I det här fallet använder vi fönstret Show-Command för att skapa ett Get-EventLog kommando som hämtar de fem senaste händelserna i Windows PowerShell-händelseloggen. När du klickar på OKreturnerar Show-Command kommandosträngen, som sparas i variabeln $C.

Exempel 8: Spara utdata från ett kommando till en variabel

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

Dessa kommandon använder parametern ErrorPopup i cmdleten Show-Command för att spara utdata från ett kommando i en variabel.

Det första kommandot kör cmdleten Show-Command med parametern ErrorPopup. Förutom att visa fel i ett fönster returnerar ErrorPopup kommandoutdata till det aktuella kommandot i stället för att skapa ett nytt kommando.

När du kör det här kommandot öppnas fönstret Show-Command. Du kan använda fönsterfunktionerna för att ange parametervärden. Om du vill köra kommandot klickar du på knappen Kör i fönstret Visa kommando.

Parametrar

-ErrorPopup

Anger att cmdleten visar fel i ett popup-fönster, förutom att visa dem på kommandoraden. När ett kommando som körs i ett Show-Command-fönstret genererar ett fel visas som standard endast felet på kommandoraden.

När du kör kommandot (med knappen Kör i fönstret Show-Command) returnerar parametern ErrorPopup kommandoresultatet till det aktuella kommandot i stället för att köra kommandot och returnera dess utdata till ett nytt kommando. Du kan använda den här funktionen för att spara kommandoresultatet i en variabel.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Height

Anger höjden på fönstret Show-Command i bildpunkter. Ange ett värde mellan 300 och antalet bildpunkter i skärmupplösningen. Om värdet är för stort för att visa kommandofönstret på skärmen genererar Show-Command ett fel. Standardhöjden är 600 bildpunkter. För ett Show-Command kommando som innehåller parametern Name är standardhöjden 300 bildpunkter.

Typ:	Double
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Visar ett kommandofönster för det angivna kommandot. Ange namnet på ett kommando, till exempel namnet på ett cmdlet-, funktions-, arbetsflödes- eller CIM-kommando. Om du utelämnar den här parametern visar Show-Command ett kommandofönster som visar alla Windows PowerShell-kommandon i alla moduler som är installerade på datorn.

Typ:	String
Alias:	CommandName
Position:	0
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-NoCommonParameter

Anger att den här cmdleten utelämnar avsnittet Gemensamma parametrar i kommandovisningen. Som standard visas vanliga parametrar i ett utökningsbart avsnitt längst ned i kommandofönstret.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten inga utdata.

Om du vill köra kommandosträngen kopierar du och klistrar in den i kommandotolken eller sparar den i en variabel och använder Invoke-Expression-cmdleten för att köra strängen i variabeln.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Width

Anger bredden på fönstret Show-Command i bildpunkter. Ange ett värde mellan 300 och antalet bildpunkter i skärmupplösningen. Om värdet är för stort för att visa kommandofönstret på skärmen genererar Show-Command ett fel. Standardbredden är 300 bildpunkter.

Typ:	Double
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Du kan inte skicka indata till Show-Command.

Utdata

System.String, System.Object

När du använder parametern PassThru returnerar Show-Command en kommandosträng. När du använder parametern ErrorPopup returnerar Show-Command kommandoutdata (valfritt objekt). Annars genererar Show-Command inga utdata.

Kommentarer

Show-Command fungerar inte i fjärrsessioner.

Dela via