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 cmdlet Show-Command 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 się. Show-Command działa na wszystkich typach poleceń, w tym polecenia cmdlet, funkcje, przepływy pracy i polecenia MODELU CIM.

Bez parametrów Show-Command wyświetla okno polecenia z 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, używając 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ąć 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 okna Show-Command. 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 domyślny okna Show-Command. 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 przedstawiono polecenie cmdlet 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 okno Show-Command dla polecenia cmdletConnect-PSSession.

Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Parametry Height i Width określają wymiar okna polecenia. Parametr ErrorPopup wyświetla okno polecenia błędu.

Po kliknięciu Uruchompolecenie Connect-PSSession zostanie uruchomione, tak jak w przypadku wpisania polecenia Connect-PSSession 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 , aby ustawić nowe wartości domyślne dlaHeight, Widthi ErrorPopup parametrów polecenia cmdlet .

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $True
}

Teraz po uruchomieniu polecenia Show-Command 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 i Out-GridView poleceń cmdlet razem.

Show-Command Get-ChildItem | Out-GridView

Polecenie używa polecenia cmdlet Show-Command, aby otworzyć okno polecenia dla polecenia cmdletGet-ChildItem. Po kliknięciu przycisku Uruchom polecenie Get-ChildItem zostanie uruchomione i wygeneruje dane wyjściowe. Operator potoku ( | ) wysyła dane wyjściowe polecenia Get-ChildItem do polecenia cmdlet Out-GridView, które wyświetla dane wyjściowe Get-ChildItem w oknie interaktywnym.

Przykład 6. Wyświetlanie polecenia utworzonego w oknie Polecenia

W tym przykładzie pokazano polecenie utworzone w oknie Show-Command. Polecenie używa parametru PassThru, który zwraca Show-Command powoduje wyświetlenie ciągu.

Show-Command -PassThru

Get-EventLog -LogName "Windows PowerShell" -Newest 5

Jeśli na przykład użyjesz okna Show-Command do utworzenia polecenia Get-EventLog, 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 uzyskiwany podczas korzystania z parametru PassThru polecenia cmdlet Show-Command. 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 PassThru polecenia cmdlet Show-Command i zapisuje wyniki polecenia w zmiennej $C. W tym przypadku użyjemy okna Show-Command, aby utworzyć polecenie Get-EventLog, które pobiera pięć najnowszych zdarzeń w dzienniku zdarzeń programu Windows PowerShell. Po kliknięciu przycisku OKprogram Show-Command zwraca 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, aby zapisać dane wyjściowe 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 tego polecenia zostanie otwarte okno Show-Command. Możesz użyć funkcji okna, aby ustawić wartości parametrów. Aby uruchomić polecenie, kliknij przycisk Uruchom w oknie Show-Command.

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 oknie Show-Command generuje błąd, błąd jest wyświetlany tylko w wierszu polecenia.

Ponadto po uruchomieniu polecenia (przy użyciu przycisku Uruchom w oknie Show-Command) ErrorPopup parametr 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ść okna Show-Command 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. W przypadku polecenia Show-Command, które zawiera 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 ten parametr zostanie pominięty, Show-Command wyświetli okno polecenia z 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 polecenia cmdlet Invoke-Expression, 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ść okna Show-Command 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 przekazać danych wejściowych potoku do Show-Command.

Dane wyjściowe

None, System.String, System.Object

Jeśli używasz parametru PassThru, Show-Command zwraca ciąg polecenia. Jeśli używasz parametru ErrorPopup, Show-Command zwraca dane wyjściowe polecenia (dowolny obiekt). W przeciwnym razie Show-Command nie generuje żadnych danych wyjściowych.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach windows.

Show-Command nie działa w sesjach zdalnych.

Udostępnij za pośrednictwem