Show-Command
A PowerShell parancsinformációinak megjelenítése grafikus ablakban.
Syntax
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 megjelenít egy parancsablakot, Show-Command
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 Parancsok listában a parancs nevére kattintva. 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, a Másolás gombra kattintva másolhatja a vágólapra a létrehozott parancsot, vagy a Futtatás gombra kattintva futtathatja a parancsot. 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 az 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 az ablak alapértelmezett nézetét Show-Command
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 Parancs ablakban. Ezzel a kijelzővel parancsokat futtathat Invoke-Command
.
Show-Command -Name "Invoke-Command"
3. példa: Parancsmag megnyitása megadott paraméterekkel
Ez a parancs megnyitja Show-Command
a parancsmag ablakátConnect-PSSession
.
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.
A Futtatás gombra kattintva a Connect-PSSession
parancs ugyanúgy fut, mintha a Connect-PSSession
parancsot a parancssorba írná be.
4. példa: Új alapértelmezett paraméterértékek megadása parancsmaghoz
Ez a példa az automatikus változót használja a $PSDefaultParameterValues
parancsmag Magasság, Szélesség és ErrorPopup paramétereinek új alapértelmezett értékeinek beállításáhozShow-Command
.
$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 változót a $PSDefaultParameterValues
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álható együtt a parancsmagok és Out-GridView
a Show-Command
parancsmagok.
Show-Command Get-ChildItem | Out-GridView
A parancs a Show-Command
parancsmaggal nyit meg egy parancsablakot aGet-ChildItem
parancsmag számára.
Amikor a Futtatás gombra kattint, a Get-ChildItem
parancs lefut, és kimenetet hoz létre. A folyamatkezelő (| ) elküldi a Get-ChildItem
parancs kimenetét a Out-GridView
parancsmagnak, amely egy 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 az ablakban létrehozott Show-Command
parancsot mutatja be. A parancs a PassThru paramétert használja, amely egy sztringben adja vissza az Show-Command
eredményeket.
Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5
Ha például az Show-Command
ablakban létrehoz egy Get-EventLog
parancsot, amely lekéri az öt legújabb eseményt a Windows PowerShell eseménynaplójában, majd kattintson az OK gombra, 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 PassThru paraméterének Show-Command
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 PassThru paraméterét Show-Command
használja, és menti a parancs eredményeit a $C
változóban. Ebben az esetben az Show-Command
ablakban létrehozunk egy Get-EventLog
parancsot, amely lekéri az öt legújabb eseményt a Windows PowerShell eseménynaplójában. Az OKShow-Command
gombra kattintva visszaadja a változóban $C
mentett parancssztringet.
8. példa: Parancs kimenetének mentése változóba
Ez a példa az ErrorPopup paraméterrel menti egy parancs kimenetét egy változóban.
$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 ablak hibáinak megjelenítése mellett az ErrorPopup parancskimenetet ad vissza az aktuális parancsnak új parancs létrehozása helyett. A parancs futtatásakor megnyílik az Show-Command
ablak. Az ablak funkcióival paraméterértékeket állíthat be. A parancs futtatásához kattintson a Futtatás gombra az 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 ablakban futtatott Show-Command
parancs alapértelmezés szerint hibát okoz, a hiba csak a parancssorban jelenik meg.
A parancs futtatásakor (az ablakban a Futtatás gombbal Show-Command
) az ErrorPopup paraméter a parancs eredményeit az aktuális parancsnak adja vissza, ahelyett, hogy a parancsot futtatja, és visszaadja a kimenetét egy új parancsnak. Ezzel a funkcióval mentheti a parancs eredményeit egy változóba.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Height
Az ablak magasságát Show-Command
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 ahhoz, hogy megjelenítse a parancsablakot a képernyőn, Show-Command
hibát okoz. Az alapértelmezett magasság 600 képpont. A Név paramétert Show-Command
tartalmazó parancsok alapértelmezett magassága 300 képpont.
Típus: | Double |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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, megjelenik egy parancsablak, Show-Command
amely felsorolja a számítógépen telepített összes modul összes PowerShell-parancsát.
Típus: | String |
Aliasok: | CommandName |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Width
Az ablak szélességét Show-Command
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 ahhoz, hogy megjelenítse a parancsablakot a képernyőn, Show-Command
hibát okoz. Az alapértelmezett szélesség 300 képpont.
Típus: | Double |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
A PassThru paraméter használatakor ez a parancsmag egy parancssztringet ad vissza.
Az ErrorPopup paraméter használatakor ez a parancsmag visszaadja a parancs kimenetét (bármilyen objektumot).
Jegyzetek
A PowerShell a következő aliasokat Show-Command
tartalmazza:
- Windows:
shcm
Ez a parancsmag csak Windows-platformokon érhető el.
Show-Command
nem működik távoli munkamenetekben.