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 (I Standard kiadás) alapértelmezés szerint megjelenik az Show-Command ablak egy változata. A parancsablak használatáról további információt a PowerShell I Standard kiadás súgótémakörében talál.
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-Command2. 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 -ErrorPopupA 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-GridViewA parancs a Show-Command parancsmaggal nyit meg egy parancsablakot aGet-ChildItemparancsmag 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 5Ha 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 powershellAz 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Double |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Aliases: | CommandName |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Double |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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-Commandtartalmazza:
- Windows:
shcm
Ez a parancsmag csak Windows-platformokon érhető el.
Show-Command nem működik távoli munkamenetekben.
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: