Show-Command

Odwołanie

Moduł:: Microsoft.PowerShell.Utility

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 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-Command

Przykł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 -ErrorPopup

Parametry 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-GridView

Polecenie 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 5

Jeś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 powershell

Opró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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	String
Aliasy:	CommandName
Position:	0
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

String

Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca ciąg polecenia.

Object

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.

Udostępnij za pośrednictwem