Show-Command

Modul:: Microsoft.PowerShell.Utility Module

A PowerShell parancsinformációinak megjelenítése grafikus ablakban.

Syntax

Default (Alapértelmezett)

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

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Show-Command parancsmaggal PowerShell-parancsot hozhat létre egy parancsablakban. A parancsot a parancsablak funkcióival futtathatja, vagy visszaadhatja a parancsot.

Show-Command egy nagyon hasznos oktatási és tanulási eszköz. Show-Command minden parancstípuson működik, beleértve a parancsmagokat, függvényeket, munkafolyamatokat és CIM-parancsokat.

Paraméterek nélkül Show-Command megjelenít egy parancsablakot, amely felsorolja az összes telepített modul összes elérhető parancsát. A modulok parancsainak megkereséséhez válassza ki a modult a Modulok legördülő listából. Parancs kiválasztásához kattintson a parancs nevére.

A parancsablak használatához válasszon ki egy parancsot a Név vagy a parancs nevére kattintva a Parancsok listában. Minden paraméterkészlet külön lapon jelenik meg. A csillag jelzi a kötelező paramétereket. Egy paraméter értékeinek megadásához írja be az értéket a szövegmezőbe, vagy válassza ki az értéket a legördülő listából. Kapcsolóparaméter hozzáadásához jelölje be a paraméter jelölőnégyzetét.

Ha elkészült, kattintson a Másolás gombra a létrehozott parancs vágólapra másolásához, vagy a parancs futtatásához kattintson a Futtatás parancsra. A PassThru paraméter használatával is visszaadhatja a parancsot a gazdaprogramnak, például a PowerShell-konzolnak. A parancs kijelölésének megszakításához és az összes parancsot megjelenítő nézethez való visszatéréshez nyomja le a Ctrl billentyűt, és kattintson a kijelölt parancsra.

A PowerShell integrált szkriptelési környezetében (ISE) alapértelmezés szerint a Show-Command ablak egy változata jelenik meg. A parancsablak használatáról a PowerShell ISE súgótémaköreiből tájékozódhat.

Ezt a parancsmagot újra bevezették a PowerShell 7-ben.

Mivel ehhez a parancsmaghoz felhasználói felület szükséges, nem működik a Windows Server Core-on vagy a Windows Nano Serveren. Ez a parancsmag csak a Windows Desktopot támogató Windows-rendszereken érhető el.

Példák

1. példa: A Parancsok ablak megnyitása

Ez a példa a Show-Command ablak alapértelmezett nézetét jeleníti meg. A Parancsok ablakban megjelenik a számítógépre telepített összes modul összes parancsának listája.

Show-Command

2. példa: Parancsmag megnyitása a Parancsok ablakban

Ez a példa a Invoke-Command parancsmagot jeleníti meg a Command ablakban. Ezzel a kijelzővel Invoke-Command parancsokat futtathat.

Show-Command -Name "Invoke-Command"

3. példa: Parancsmag megnyitása megadott paraméterekkel

Ez a parancs megnyitja aShow-Commandparancsmag Connect-PSSession ablakát.

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

A Magasság és Szélesség paraméterek határozzák meg a parancsablak méretét. Az ErrorPopup paraméter megjeleníti a hibaparancsablakot.

Amikor a Futtatásgombra kattint, a Connect-PSSession parancs ugyanúgy fut, mintha a parancssorba írja be a Connect-PSSession parancsot.

4. példa: Új alapértelmezett paraméterértékek megadása parancsmaghoz

Ez a példa a $PSDefaultParameterValues automatikus változóval állítja be a Magasság, Szélességés ErrorPopup paraméter új alapértelmezett értékeit a Show-Command parancsmaghoz.

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

Most, amikor futtat egy Show-Command parancsot, a rendszer automatikusan alkalmazza az új alapértelmezett értékeket. Ha ezeket az alapértelmezett értékeket minden PowerShell-munkamenetben használni szeretné, adja hozzá a $PSDefaultParameterValues változót a PowerShell-profiljához. További információ: about_Profiles és about_Parameters_Default_Values.

5. példa: Kimenet küldése rácsnézetbe

Ez a parancs bemutatja, hogyan használhatja együtt a Show-Command és Out-GridView parancsmagokat.

Show-Command Get-ChildItem | Out-GridView

A parancs a Show-Command parancsmaggal nyit meg egy parancsablakot aGet-ChildItemparancsmaghoz. Amikor a Futtatás gombra kattint, a Get-ChildItem parancs fut, és kimenetet hoz létre. A folyamatkezelő (| ) elküldi a Get-ChildItem parancs kimenetét a Out-GridView parancsmagnak, amely interaktív ablakban jeleníti meg a Get-ChildItem kimenetet.

6. példa: A Parancsok ablakban létrehozott parancs megjelenítése

Ez a példa a Show-Command ablakban létrehozott parancsot mutatja be. A parancs a PassThru paramétert használja, amely visszaadja a Show-Command eredményt egy sztringben.

Show-Command -PassThru

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

Ha például a Show-Command ablakban hoz létre egy Get-EventLog parancsot, amely lekéri az öt legújabb eseményt a Windows PowerShell eseménynaplójában, majd kattintson OKgombra, a parancs a fent látható kimenetet adja vissza. A parancssztring megtekintése segít a PowerShell megismerésében.

7. példa: Parancs mentése változóba

Ez a példa bemutatja, hogyan futtathatja a parancsmag Show-Command paraméterének használatakor megkapott parancssztringet. Ez a stratégia lehetővé teszi a parancs megtekintését és használatát.

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

Az első parancs a parancsmag Show-Command paraméterét használja, és menti a parancs eredményeit a $C változóban. Ebben az esetben a Show-Command ablakban hozunk létre egy Get-EventLog parancsot, amely lekéri az öt legújabb eseményt a Windows PowerShell eseménynaplójában. Ha OKgombra kattint, Show-Command a $C változóba mentett parancssztringet adja vissza.

8. példa: Parancs kimenetének mentése változóba

Ez a példa a ErrorPopup paraméterrel menti egy parancs kimenetét egy változóba.

$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

Az ablakban megjelenő hibák mellett az ErrorPopup parancskimenetet ad vissza az aktuális parancsnak új parancs létrehozása helyett. A parancs futtatásakor megnyílik a Show-Command ablak. Az ablak funkcióival paraméterértékeket állíthat be. A parancs futtatásához kattintson a futtatása gombra a Show-Command ablakban.

Paraméterek

-ErrorPopup

Azt jelzi, hogy a parancsmag egy előugró ablakban jeleníti meg a hibákat, valamint megjeleníti őket a parancssorban. Ha egy Show-Command ablakban futtatott parancs alapértelmezés szerint hibát okoz, a hiba csak a parancssorban jelenik meg.

A parancs futtatásakor (a ablakban a Show-Command gomb használatával) az ErrorPopup paraméter a parancs eredményeit az aktuális parancsra adja vissza a parancs futtatása és kimenetének új parancsba való visszaadása helyett. Ezzel a funkcióval mentheti a parancs eredményeit egy változóba.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Height

A Show-Command ablak magasságát adja meg képpontban. Adjon meg egy 300 és a képpontok száma közötti értéket a képernyőfelbontásban. Ha az érték túl nagy a parancsablak képernyőn való megjelenítéséhez, Show-Command hibát okoz. Az alapértelmezett magasság 600 képpont. A Show-Command paramétert tartalmazó parancs esetén az alapértelmezett magasság 300 képpont.

Paramétertulajdonságok

Típus:	Double
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Name

Megjeleníti a megadott parancs parancsablakát. Adja meg egy parancs nevét, például egy parancsmag, függvény vagy CIM-parancs nevét. Ha kihagyja ezt a paramétert, Show-Command megjelenít egy parancsablakot, amely felsorolja a számítógépen telepített összes modul összes PowerShell-parancsát.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	CommandName

Paraméterkészletek

(All)

Position:	0
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-NoCommonParameter

Azt jelzi, hogy ez a parancsmag kihagyja a parancsmegjelenítés Common Parameters szakaszát. Alapértelmezés szerint a Common Parameters egy kibontható szakaszban jelenik meg a parancsablak alján.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet. A parancssztring futtatásához másolja és illessze be a parancssorba, vagy mentse egy változóba, és a Invoke-Expression parancsmaggal futtassa a sztringet a változóban.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Width

A Show-Command ablak szélességét adja meg képpontban. Adjon meg egy 300 és a képpontok száma közötti értéket a képernyőfelbontásban. Ha az érték túl nagy a parancsablak képernyőn való megjelenítéséhez, Show-Command hibát okoz. Az alapértelmezett szélesség 300 képpont.

Paramétertulajdonságok

Típus:	Double
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

String

A PassThru paraméter használatakor ez a parancsmag egy parancssztringet ad vissza.

Object

A ErrorPopup paraméter használatakor ez a parancsmag visszaadja a parancs kimenetét (bármilyen objektumot).

Jegyzetek

A PowerShell a következő aliasokat tartalmazza Show-Command:

Windows:
- shcm

Ez a parancsmag csak Windows-platformokon érhető el.

Show-Command nem működik távoli munkamenetekben.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Megosztás a következőn keresztül:

Show-Command

Syntax

Default (Alapértelmezett)

Description

Példák

1. példa: A Parancsok ablak megnyitása

2. példa: Parancsmag megnyitása a Parancsok ablakban

3. példa: Parancsmag megnyitása megadott paraméterekkel

4. példa: Új alapértelmezett paraméterértékek megadása parancsmaghoz

5. példa: Kimenet küldése rácsnézetbe

6. példa: A Parancsok ablakban létrehozott parancs megjelenítése

7. példa: Parancs mentése változóba

8. példa: Parancs kimenetének mentése változóba

Paraméterek

-ErrorPopup

Paramétertulajdonságok

Paraméterkészletek

-Height

Paramétertulajdonságok

Paraméterkészletek

-Name

Paramétertulajdonságok

Paraméterkészletek

-NoCommonParameter

Paramétertulajdonságok

Paraméterkészletek

-PassThru

Paramétertulajdonságok

Paraméterkészletek

-Width

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Bevitelek

None

Kimenetek

None

String

Object

Jegyzetek

Visszajelzés