Show-Command
Windows PowerShell-parancsokat hoz létre egy grafikus parancsablakban.
Syntax
Default (Alapértelmezett)
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]
Description
A Show-Command parancsmaggal windowsos 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 Windows 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 Windows PowerShell integrált szkriptelési környezetében (ISE) alapértelmezés szerint megjelenik a Show-Command ablak egy változata. A parancsablak használatáról a Windows PowerShell ISE súgótémaköreiből tájékozódhat.
Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.
Példák
1. példa: A Parancsok ablak megnyitása
PS C:\> Show-Command
Ez a parancs 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.
2. példa: Parancsmag megnyitása a Parancsok ablakban
PS C:\> Show-Command -Name "Invoke-Command"
Ez a parancs megnyitja a Invoke-Command parancsmagot a Parancs megjelenítése ablakban. Az Invoke-Command kijelzővel futtathat Invoke-Command parancsokat.
3. példa: Parancsmag megnyitása megadott paraméterekkel
PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup
Ez a parancs megnyitja a Connect-PSSession parancsmag Parancs megjelenítése ablakát. A Magasság és Szélesség paraméterekkel adja meg a parancsablak méretét, valamint a ErrorPopup paramétert a hibaparancsablak megjelenítéséhez.
Amikor a Futtatásgombra kattint, a Connect-PSSession parancs fut, ugyanúgy, mintha a parancssorba írja be a Connect-PSSession parancsot.
4. példa: Új alapértelmezett paraméterértékek megadása parancsmaghoz
PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}
Ez a parancs a $PSDefaultParameterValues automatikus változóval állítja be a Magasság, Szélességés Show-Command parancsmag paraméterének új alapértelmezett értékeit. 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 Windows PowerShell-munkamenetben használni szeretné, adja hozzá a $PSDefaultParameterValues változót a Windows PowerShell-profiljához. További információ: about_Profiles és about_Parameters_Default_Values.
5. példa: Kimenet küldése rácsnézetbe
PS C:\> Show-Command Get-ChildItem | Out-GridView
Ez a parancs bemutatja, hogyan használhatja együtt a Show-Command és Out-GridView parancsmagokat.
A parancs a Show-Command parancsmaggal nyit meg egy parancsablakot a Get-ChildItem parancsmaghoz. Amikor a Futtatás gombra kattint, a Get-ChildItem parancs lefut, és kimenetet hoz létre. A folyamatüzemeltető (| ) 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
PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5
Ez a parancs a Show-Command ablakban létrehozott parancsot jeleníti meg. A parancs a PassThru paramétert használja, amely visszaadja a Show-Command eredménye egy sztringet.
Ha például a Parancs megjelenítése 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 következő kimenetet adja vissza.
A parancssztring megtekintése segít a Windows PowerShell megismerésében.
7. példa: Parancs mentése változóba
PS C:\> $C = Show-Command -PassThru
This command displays the command string in the $C variable.
PS C:\> $C
Get-EventLog -LogName "Windows PowerShell" -Newest 5
These commands use the Invoke-Expression cmdlet to run the string in the $C variable. The first command uses the full cmdlet name. The second command uses the "iex" alias for the **Invoke-Expression** cmdlet. These commands are equivalent and you can use them interchangeably.The output shows the five newest events in the Windows PowerShell event log.
PS C:\> Invoke-Expression $C
PS C:\> iex $C
Index Time EntryType Source InstanceID Message
----- ---- --------- ------ ---------- -------
11520 Dec 16 16:37 Information PowerShell 400 Engine state is changed from None to Available....
11519 Dec 16 16:37 Information PowerShell 600 Provider "Variable" is Started. ...
11518 Dec 16 16:37 Information PowerShell 600 Provider "Registry" is Started. ...
11517 Dec 16 16:37 Information PowerShell 600 Provider "Function" is Started. ...
11516 Dec 16 16:37 Information PowerShell 600 Provider "FileSystem" is Started. ...
Ez a parancs bemutatja, hogyan futtathatja a
Az első parancs a Show-Command parancsmag PassThru paraméterét használja. Menti a parancs eredményeit a $C változóban.
A parancs megnyit egy Parancs megjelenítése ablakot. Ebben az esetben a Show-Command ablakban hozzunk 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, Parancs megjelenítése a $C változóban mentett parancssztringet adja vissza.
8. példa: Parancs kimenetének mentése változóba
PS C:\> $P = Show-Command Get-Process -ErrorPopup
The second command displays the value in the $P variable.
PS C:\> $P
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
473 33 94096 112532 709 2.06 4492 powershell
Ezek a parancsok a Show-Command parancsmag ErrorPopup paraméterével mentik egy parancs kimenetét egy változóban.
Az első parancs a Show-Command parancsmagot futtatja az ErrorPopup paraméterrel. 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ás gombra a Parancs megjelenítése 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. Alapértelmezés szerint, ha egy Show-Command ablakban futó parancs hibát generál, a hiba csak a parancssorban jelenik meg.
A parancs futtatásakor (a Show-Command ablakban található Futtatás gomb használatával) az ErrorPopup paraméter a parancs eredményeit adja vissza az aktuális parancsnak 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: | 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 |
-Height
A Show-Command ablakának képpontban megadott magasságát adja meg. 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, Parancs megjelenítése hibát okoz. Az alapértelmezett magasság 600 képpont. A Name paramétert tartalmazó Show-Command 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, munkafolyamat vagy CIM-parancs nevét. Ha kihagyja ezt a paramétert, Show-Command megjelenít egy parancsablakot, amely a számítógépen telepített összes modulban felsorolja az összes Windows PowerShell-parancsot.
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: | 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 |
-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: | 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 |
-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, Parancs megjelenítése 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
A Show-Commandnem tudja becsúszni a bemenetbe.
Kimenetek
System.String, System.Object
Ha a PassThru paramétert használja, Show-Command egy parancssztringet ad vissza. Ha a ErrorPopup paramétert használja, Show-Command a parancs kimenetét (bármely objektumot) adja vissza. Ellenkező esetben Show-Command nem hoz létre kimenetet.
Jegyzetek
- Show-Command nem működik távoli munkamenetekben.