Show-Command

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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Med cmdleten Show-Command kan du skapa ett 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 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 PowerShell Integrated Scripting Environment (ISE) visas en variant av Show-Command-fönstret som standard. Information om hur du använder det här kommandofönstret finns i hjälpavsnitten för PowerShell ISE.

Den här cmdleten återinfördes i PowerShell 7.

Eftersom den här cmdleten kräver ett användargränssnitt fungerar den inte på Windows Server Core eller Windows Nano Server. Den här cmdleten är endast tillgänglig i Windows-system som stöder Windows Desktop.

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

Show-Command

I det här exemplet visas cmdleten Invoke-Command i fönstret Kommando. Du kan använda den här skärmen för att köra Invoke-Command kommandon.

Show-Command -Name "Invoke-Command"

Det här kommandot öppnar ett Show-Command fönster för cmdletenConnect-PSSession.

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

Parametrarna Height och Width anger dimensionen för kommandofönstret. Parametern ErrorPopup visar 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.

I det här exemplet används den automatiska variabeln $PSDefaultParameterValues för att ange nya standardvärden för parametrarna Height, Widthoch ErrorPopup för cmdleten Show-Command.

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

Nu när du kör ett Show-Command kommando tillämpas de nya standardvärdena automatiskt. Om du vill använda dessa standardvärden i varje PowerShell-session lägger du till variabeln $PSDefaultParameterValues i PowerShell-profilen. Mer information finns i about_Profiles och about_Parameters_Default_Values.

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

Show-Command Get-ChildItem | Out-GridView

Kommandot använder cmdleten Show-Command för att öppna ett kommandofönster för cmdletenGet-ChildItem. När du klickar på knappen Kör körs Get-ChildItem-kommandot 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.

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

Show-Command -PassThru

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

Om du till exempel använder Show-Command-fönstret 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 utdata som visas ovan. Om du visar kommandosträngen får du hjälp att lära dig PowerShell.

Det här exemplet 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.

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

Det första kommandot använder parametern PassThru för cmdleten Show-Command och sparar resultatet av kommandot i variabeln $C. 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.

I det här exemplet används parametern ErrorPopup för att spara utdata från ett kommando i en variabel.

$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

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

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan inte skicka objekt till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten en kommandosträng.

När du använder parametern ErrorPopup returnerar den här cmdleten kommandoutdata (valfritt objekt).

PowerShell innehåller följande alias för Show-Command:

• Windows:
  • shcm

Den här cmdleten är endast tillgänglig på Windows-plattformar.

Show-Command fungerar inte i fjärrsessioner.