Show-Command

Moduł:: Microsoft.PowerShell.Utility Module

Wyświetla informacje o poleceniach programu PowerShell w oknie graficznym.

Składnia

Default (Domyślna)

Show-Command
    [[-Name] <String>]
    [-Height <Double>]
    [-Width <Double>]
    [-NoCommonParameter]
    [-ErrorPopup]
    [-PassThru]
    [<CommonParameters>]

Opis

Ten cmdlet jest dostępny 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, 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 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-ChildItemUruchom 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-CommandPassThru 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-CommandPassThru 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 OKShow-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 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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	Double
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	CommandName

Zestawy parametrów

(All)

Position:	0
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	Double
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Nie można przekazywać obiektów do tego cmdletu.

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

Windows:
- shcm

Ten cmdlet jest dostępny tylko na platformach Windows.

Show-Command nie działa w sesjach zdalnych.

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij za pomocą

Show-Command

Składnia

Default (Domyślna)

Opis

Przykłady

Przykład 1. Otwieranie okna Polecenia

Przykład 2. Otwieranie polecenia cmdlet w oknie Polecenia

Przykład 3. Otwieranie polecenia cmdlet z określonymi parametrami

Przykład 4. Określanie nowych domyślnych wartości parametrów dla polecenia cmdlet

Przykład 5. Wysyłanie danych wyjściowych do widoku siatki

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

Przykład 7. Zapisywanie polecenia w zmiennej

Przykład 8. Zapisywanie danych wyjściowych polecenia w zmiennej

Parametry

-ErrorPopup

Właściwości parametru

Zestawy parametrów

-Height

Właściwości parametru

Zestawy parametrów

-Name

Właściwości parametru

Zestawy parametrów

-NoCommonParameter

Właściwości parametru

Zestawy parametrów

-PassThru

Właściwości parametru

Zestawy parametrów

-Width

Właściwości parametru

Zestawy parametrów

CommonParameters

Dane wejściowe

None

Dane wyjściowe

None

String

Object

Uwagi

Sprzężenie zwrotne