Show-Command

Referens

Modul:: Microsoft.PowerShell.Utility

Visar PowerShell-kommandoinformation i ett grafiskt fönster.

Syntax

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

Description

Med Show-Command cmdleten 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 Show-Command visas 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 fönstret Show-Command 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 introducerades i PowerShell 3.0.

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.

Exempel

Exempel 1: Öppna fönstret Kommandon

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

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

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

Show-Command -Name "Invoke-Command"

Exempel 3: Öppna en cmdlet med angivna parametrar

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 Höjd och Bredd anger dimensionen för kommandofönstret. Parametern ErrorPopup visar felkommandofönstret.

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

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

I det här exemplet används den $PSDefaultParameterValues automatiska variabeln för att ange nya standardvärden för parametrarna Höjd, Bredd och 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 i $PSDefaultParameterValues din PowerShell-profil. Mer information finns i about_Profiles och about_Parameters_Default_Values.

Exempel 5: Skicka utdata till en rutnätsvy

Det här kommandot visar hur du använder Show-Command cmdletarna 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 Get-ChildItem Kör körs kommandot och genererar utdata. Pipelineoperatorn ( | ) skickar utdata från Get-ChildItem kommandot till cmdleten Out-GridViewGet-ChildItem , som visar utdata i ett interaktivt fönster.

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

Det här exemplet visar kommandot som du skapade i fönstret Show-Command . Kommandot använder parametern PassThru , som returnerar Show-Command resultatet 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å OK, returnerar kommandot utdata som visas ovan. Om du visar kommandosträngen får du hjälp att lära dig PowerShell.

Exempel 7: Spara ett kommando i en variabel

Det här exemplet visar hur du kör kommandosträngen som du får när du använder parametern PassThru för 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 i 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å OK Show-Commandreturnerar kommandosträngen, som sparas i variabeln$C.

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

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 .

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önster genererar ett fel visas som standard endast på kommandoraden.

När du kör kommandot (med knappen Kör i Show-Command fönstret) 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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Height

Anger fönstrets höjd 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 Show-Command genererar ett fel. Standardhöjden är 600 bildpunkter. För ett Show-Command kommando som innehåller parametern Namn är standardhöjden 300 bildpunkter.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Aliases:	CommandName
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 och klistrar du in den i kommandotolken eller sparar den i en variabel och använder cmdleten Invoke-Expression för att köra strängen i variabeln.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Width

Anger fönstrets bredd 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 Show-Command genererar ett fel. Standardbredden är 300 bildpunkter.

Type:	Double
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

None

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

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

String

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

Object

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

Kommentarer

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

shcm

Show-Command fungerar inte i fjärrsessioner.