Show-Command
Wyświetla informacje o poleceniach programu PowerShell w oknie graficznym.
Składnia
Show-Command
[[-Name] <String>]
[-Height <Double>]
[-Width <Double>]
[-NoCommonParameter]
[-ErrorPopup]
[-PassThru]
[<CommonParameters>]Opis
To polecenie cmdlet jest dostępne tylko na platformie Windows.
Polecenie Show-Command cmdlet umożliwia utworzenie polecenia programu PowerShell w oknie polecenia. Możesz użyć funkcji okna poleceń, aby uruchomić polecenie lub zwrócić polecenie.
Show-Command jest bardzo przydatnym narzędziem do nauczania i uczenia. Show-Command działa na wszystkich typach poleceń, w tym polecenia cmdlet, funkcje, przepływy pracy i polecenia MODELU CIM.
Bez parametrów wyświetla okno polecenia z Show-Command listą wszystkich dostępnych poleceń we wszystkich zainstalowanych modułach. Aby znaleźć polecenia w module, wybierz moduł z listy rozwijanej Moduły. Aby wybrać polecenie, kliknij nazwę polecenia.
Aby użyć okna poleceń, wybierz polecenie przy użyciu nazwy lub klikając nazwę polecenia na liście Polecenia . Każdy zestaw parametrów jest wyświetlany na osobnej karcie. Gwiazdki wskazują obowiązkowe parametry. Aby wprowadzić wartości parametru, wpisz wartość w polu tekstowym lub wybierz wartość z pola listy rozwijanej. Aby dodać parametr przełącznika, kliknij, aby zaznaczyć pole wyboru parametru.
Gdy wszystko będzie gotowe, możesz kliknąć przycisk Kopiuj , aby skopiować utworzone polecenie do schowka lub kliknąć przycisk Uruchom , aby uruchomić polecenie. Możesz również użyć parametru PassThru , aby zwrócić polecenie do programu hosta, takiego jak konsola programu PowerShell. Aby anulować zaznaczenie polecenia i wrócić do widoku, który wyświetla wszystkie polecenia, naciśnij klawisze Ctrl i kliknij wybrane polecenie.
W zintegrowanym środowisku skryptowym programu PowerShell (ISE) domyślnie jest wyświetlana odmiana Show-Command okna. Aby uzyskać informacje na temat korzystania z tego okna poleceń, zobacz tematy pomocy programu PowerShell ISE.
To polecenie cmdlet zostało ponownie wprowadzone w programie PowerShell 7.
Ponieważ to polecenie cmdlet wymaga interfejsu użytkownika, nie działa w systemie Windows Server Core lub Windows Nano Server. To polecenie cmdlet jest dostępne tylko w systemach Windows, które obsługują program Windows Desktop.
Przykłady
Przykład 1. Otwieranie okna Polecenia
W tym przykładzie zostanie wyświetlony widok Show-Command domyślny okna. W oknie Polecenia zostanie wyświetlona lista wszystkich poleceń we wszystkich modułach zainstalowanych na komputerze.
Show-CommandPrzykład 2. Otwieranie polecenia cmdlet w oknie Polecenia
W tym przykładzie polecenie cmdlet jest wyświetlane Invoke-Command w oknie Polecenia. Ten ekran służy do uruchamiania Invoke-Command poleceń.
Show-Command -Name "Invoke-Command"Przykład 3. Otwieranie polecenia cmdlet z określonymi parametrami
To polecenie otwiera Show-Command okno poleceniaConnect-PSSessioncmdlet.
Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopupParametry Height (Wysokość) i Width (Szerokość) określają wymiar okna poleceń. Parametr ErrorPopup wyświetla okno polecenia błędu.
Po kliknięciu Connect-PSSession przycisku Uruchom polecenie zostanie uruchomione, tak samo jak w przypadku wpisania Connect-PSSession polecenia w wierszu polecenia.
Przykład 4. Określanie nowych domyślnych wartości parametrów dla polecenia cmdlet
W tym przykładzie użyto zmiennej automatycznej $PSDefaultParameterValues , aby ustawić nowe wartości domyślne parametrów Height, Width i ErrorPopup polecenia Show-Command cmdlet.
$PSDefaultParameterValues = @{
"Show-Command:Height" = 700
"Show-Command:Width" = 1000
"Show-Command:ErrorPopup" = $True
}Teraz po uruchomieniu Show-Command polecenia nowe wartości domyślne są stosowane automatycznie. Aby użyć tych wartości domyślnych w każdej sesji programu PowerShell, dodaj zmienną $PSDefaultParameterValues do profilu programu PowerShell. Aby uzyskać więcej informacji, zobacz about_Profiles i about_Parameters_Default_Values.
Przykład 5. Wysyłanie danych wyjściowych do widoku siatki
To polecenie pokazuje, jak używać Show-Command poleceń cmdlet i Out-GridView razem.
Show-Command Get-ChildItem | Out-GridViewPolecenie używa Show-Command polecenia cmdlet, aby otworzyć okno polecenia dlaGet-ChildItempolecenia cmdlet.
Po kliknięciu przycisku Get-ChildItem Uruchom polecenie zostanie uruchomione i wygeneruje dane wyjściowe. Operator potoku ( | ) wysyła dane wyjściowe Get-ChildItem polecenia do Out-GridView polecenia cmdlet, które wyświetla Get-ChildItem dane wyjściowe w oknie interaktywnym.
Przykład 6. Wyświetlanie polecenia utworzonego w oknie Polecenia
W tym przykładzie Show-Command pokazano polecenie utworzone w oknie. Polecenie używa parametru PassThru , który zwraca Show-Command wyniki w ciągu.
Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5Jeśli na przykład użyjesz Show-Command okna, aby utworzyć Get-EventLog polecenie, które pobiera pięć najnowszych zdarzeń w dzienniku zdarzeń programu Windows PowerShell, a następnie kliknij przycisk OK, polecenie zwróci dane wyjściowe pokazane powyżej. Wyświetlenie ciągu polecenia ułatwia naukę programu PowerShell.
Przykład 7. Zapisywanie polecenia w zmiennej
W tym przykładzie pokazano, jak uruchomić ciąg polecenia otrzymany podczas korzystania z parametru Show-Command PassThru polecenia cmdlet. Ta strategia umożliwia wyświetlenie polecenia i użycie go.
$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. ...Pierwsze polecenie używa parametru Show-Command PassThru polecenia cmdlet i zapisuje wyniki polecenia w zmiennej$C. W tym przypadku użyjemy Show-Command okna, aby utworzyć Get-EventLog polecenie, które pobiera pięć najnowszych zdarzeń w dzienniku zdarzeń programu Windows PowerShell. Po kliknięciu przycisku OK Show-Commandzwraca ciąg polecenia, który jest zapisywany w zmiennej$C.
Przykład 8. Zapisywanie danych wyjściowych polecenia w zmiennej
W tym przykładzie użyto parametru ErrorPopup do zapisania danych wyjściowych polecenia w zmiennej.
$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 powershellOprócz wyświetlania błędów w oknie, ErrorPopup zwraca dane wyjściowe polecenia do bieżącego polecenia, zamiast tworzyć nowe polecenie. Po uruchomieniu Show-Command tego polecenia zostanie otwarte okno. Możesz użyć funkcji okna, aby ustawić wartości parametrów. Aby uruchomić polecenie, kliknij przycisk Uruchom w Show-Command oknie.
Parametry
-ErrorPopup
Wskazuje, że polecenie cmdlet wyświetla błędy w oknie podręcznym, oprócz wyświetlania ich w wierszu polecenia. Domyślnie, gdy polecenie uruchamiane w Show-Command oknie generuje błąd, błąd jest wyświetlany tylko w wierszu polecenia.
Ponadto po uruchomieniu polecenia (przy użyciu przycisku Uruchom w Show-Command oknie) parametr ErrorPopup zwraca wyniki polecenia do bieżącego polecenia, zamiast uruchamiać polecenie i zwracać jego dane wyjściowe do nowego polecenia. Tej funkcji można użyć do zapisania wyników polecenia w zmiennej.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Height
Określa wysokość Show-Command okna w pikselach. Wprowadź wartość z zakresu od 300 do liczby pikseli w rozdzielczości ekranu. Jeśli wartość jest zbyt duża, aby wyświetlić okno polecenia na ekranie, Show-Command generuje błąd. Domyślna wysokość to 600 pikseli. Show-Command W przypadku polecenia zawierającego parametr Name domyślna wysokość to 300 pikseli.
| Type: | Double |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Wyświetla okno polecenia dla określonego polecenia. Wprowadź nazwę jednego polecenia, na przykład nazwę polecenia cmdlet, funkcji lub polecenia CIM. Jeśli pominięto ten parametr, zostanie wyświetlone okno polecenia zawierające Show-Command listę wszystkich poleceń programu PowerShell we wszystkich modułach zainstalowanych na komputerze.
| Type: | String |
| Aliases: | CommandName |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoCommonParameter
Wskazuje, że to polecenie cmdlet pomija sekcję Common Parameters wyświetlanego polecenia. Domyślnie wspólne parametry są wyświetlane w rozwijanej sekcji w dolnej części okna polecenia.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych. Aby uruchomić ciąg polecenia, skopiuj go i wklej w wierszu polecenia lub zapisz go w zmiennej i użyj Invoke-Expression polecenia cmdlet, aby uruchomić ciąg w zmiennej.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Width
Określa szerokość Show-Command okna w pikselach. Wprowadź wartość z zakresu od 300 do liczby pikseli w rozdzielczości ekranu. Jeśli wartość jest zbyt duża, aby wyświetlić okno polecenia na ekranie, Show-Command generuje błąd. Domyślna szerokość to 300 pikseli.
| Type: | Double |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
None
Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca ciąg polecenia.
Jeśli używasz parametru ErrorPopup , to polecenie cmdlet zwraca dane wyjściowe polecenia (dowolny obiekt).
Uwagi
Program PowerShell zawiera następujące aliasy dla programu Show-Command:
- Windows:
shcm
To polecenie cmdlet jest dostępne tylko na platformach windows.
Show-Command nie działa w sesjach zdalnych.
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla