Show-Command

Zeigt PowerShell-Befehlsinformationen in einem grafischen Fenster an.

Syntax

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

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Mit dem Show-Command Cmdlet können Sie einen PowerShell-Befehl in einem Befehlsfenster erstellen. Mithilfe der Funktionen des Befehlsfensters können Sie den Befehl ausführen oder den Befehl an Sie zurückgeben lassen.

Show-Command ist ein sehr nützliches Lehr- und Lerntool. Show-Command funktioniert auf allen Befehlstypen, einschließlich Cmdlets, Funktionen, Workflows und CIM-Befehlen.

Ohne Parameter wird ein Befehlsfenster angezeigt, Show-Command das alle verfügbaren Befehle in allen installierten Modulen auflistet. Um die Befehle in einem Modul zu suchen, wählen Sie das Modul aus der Dropdownliste „Module“ aus. Klicken Sie zum Auswählen eines Befehls auf den Befehlsnamen.

Um das Befehlsfenster zu verwenden, wählen Sie einen Befehl aus, entweder mithilfe des Namens oder durch Klicken auf den Befehlsnamen in der Befehlsliste . Jeder Parametersatz wird auf einer separaten Registerkarte angezeigt. Sternchen geben die obligatorischen Parameter an. Um Werte für einen Parameter einzugeben, geben Sie den Wert in das Textfeld ein, oder wählen Sie den Wert aus der Dropdownliste aus. Um einen Switch-Parameter hinzuzufügen, aktivieren Sie das Parameter-Kontrollkästchen.

Sobald Sie bereit sind, können Sie auf Copy klicken, um den Befehl, den Sie erstellt haben, in die Zwischenablage zu kopieren, oder klicken Sie auf Run, um den Befehl auszuführen. Sie können auch den PassThru-Parameter verwenden, um den Befehl an das Hostprogramm zurückzugeben, z. B. die PowerShell-Konsole. Um die Befehlsauswahl abzubrechen und zur Ansicht zurückzukehren, die alle Befehle anzeigt, drücken Sie STRG, und klicken Sie auf den ausgewählten Befehl.

In der integrierten Skriptumgebung (PowerShell Integrated Scripting Environment, ISE) wird standardmäßig eine Variation des Show-Command Fensters angezeigt. Informationen zur Verwendung dieses Befehlsfensters finden Sie in den PowerShell ISE-Hilfethemen.

Dieses Cmdlet wurde in PowerShell 7 erneut eingeführt.

Da dieses Cmdlet eine Benutzeroberfläche erfordert, funktioniert es nicht auf Windows Server Core oder Windows Nano Server. Dieses Cmdlet ist nur auf Windows-Systemen verfügbar, die den Windows-Desktop unterstützen.

Beispiele

Beispiel 1: Öffnen des Befehlsfensters

In diesem Beispiel wird die Standardansicht des Show-Command Fensters angezeigt. Das Fenster "Befehle " zeigt eine Liste aller Befehle in allen Modulen an, die auf dem Computer installiert sind.

Show-Command

Beispiel 2: Öffnen eines Cmdlets im Fenster "Befehle"

In diesem Beispiel wird das Invoke-Command Cmdlet im Befehlsfenster angezeigt. Sie können diese Anzeige verwenden, um Befehle auszuführen Invoke-Command .

Show-Command -Name "Invoke-Command"

Beispiel 3: Öffnen eines Cmdlets mit angegebenen Parametern

Dieser Befehl öffnet ein Show-Command Fenster für dasConnect-PSSessionCmdlet.

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

Die Parameter "Height " und "Width " geben die Dimension des Befehlsfensters an. Der Parameter ErrorPopup zeigt das Fehlerbefehlsfenster an.

Wenn Sie auf "Ausführen" klicken, wird der Connect-PSSession Befehl ausgeführt, genau wie wenn Sie den Connect-PSSession Befehl in die Befehlszeile eingegeben haben.

Beispiel 4: Angeben neuer Standardwerte für ein Cmdlet

In diesem Beispiel wird die $PSDefaultParameterValues automatische Variable verwendet, um neue Standardwerte für die Parameter "Height", "Width" und "ErrorPopup " des Show-Command Cmdlets festzulegen.

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

Wenn Sie nun einen Show-Command Befehl ausführen, werden die neuen Standardwerte automatisch angewendet. Um diese Standardwerte in jeder PowerShell-Sitzung zu verwenden, fügen Sie die $PSDefaultParameterValues Variable ihrem PowerShell-Profil hinzu. Weitere Informationen finden Sie unter about_Profiles und about_Parameters_Default_Values.

Beispiel 5: Senden der Ausgabe an eine Rasteransicht

Dieser Befehl zeigt, wie Sie die Show-Command und Out-GridView die Cmdlets zusammen verwenden.

Show-Command Get-ChildItem | Out-GridView

Der Befehl verwendet das Show-Command Cmdlet, um ein Befehlsfenster für dasGet-ChildItemCmdlet zu öffnen. Wenn Sie auf die Schaltfläche "Ausführen" klicken, wird der Get-ChildItem Befehl ausgeführt und generiert die Ausgabe. Der Pipelineoperator ( | ) sendet die Ausgabe des Get-ChildItem Befehls an das Out-GridView Cmdlet, das die Get-ChildItem Ausgabe in einem interaktiven Fenster anzeigt.

Beispiel 6: Anzeigen eines Befehls, den Sie im Fenster "Befehle" erstellen

In diesem Beispiel wird der Befehl gezeigt, den Sie im Show-Command Fenster erstellt haben. Der Befehl verwendet den PassThru-Parameter , der die Show-Command Ergebnisse in einer Zeichenfolge zurückgibt.

Show-Command -PassThru

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

Wenn Sie beispielsweise das Fenster verwenden, um einen Get-EventLog Befehl zu erstellen, der Show-Command die fünf neuesten Ereignisse im Windows PowerShell Ereignisprotokoll abruft, und klicken Sie dann auf OK, der Befehl gibt die oben gezeigte Ausgabe zurück. Wenn Sie die Befehlszeichenfolge anzeigen, können Sie PowerShell erlernen.

Beispiel 7: Speichern eines Befehls in einer Variablen

In diesem Beispiel wird gezeigt, wie Sie die Befehlszeichenfolge ausführen, die Sie erhalten, wenn Sie den PassThru-Parameter des Show-Command Cmdlets verwenden. Mit dieser Strategie können Sie den Befehl anzeigen und ihn verwenden.

$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. ...

Der erste Befehl verwendet den PassThru-Parameter des Show-Command Cmdlets und speichert die Ergebnisse des Befehls in der $C Variablen. In diesem Fall verwenden wir das Show-Command Fenster, um einen Get-EventLog Befehl zu erstellen, der die fünf neuesten Ereignisse im Windows PowerShell Ereignisprotokoll abruft. Wenn Sie auf "OK" klicken, wird die Befehlszeichenfolge zurückgegeben, Show-Command die in der $C Variablen gespeichert wird.

Beispiel 8: Speichern der Ausgabe eines Befehls in einer Variablen

In diesem Beispiel wird der ErrorPopup-Parameter verwendet, um die Ausgabe eines Befehls in einer Variablen zu speichern.

$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

Zusätzlich zum Anzeigen von Fehlern in einem Fenster gibt ErrorPopup die Ausgabe des Befehls an den aktuellen Befehl zurück, anstatt einen neuen Befehl zu erstellen. Wenn Sie diesen Befehl ausführen, wird das Show-Command Fenster geöffnet. Mithilfe der Funktionen des Fensters können Sie Parameterwerte festlegen. Klicken Sie zum Ausführen des Befehls im Show-Command Fenster auf die Schaltfläche "Ausführen".

Parameter

-ErrorPopup

Gibt an, dass das Cmdlet Fehler in einem Popupfenster anzeigt, zusätzlich zum Anzeigen der Cmdlets in der Befehlszeile. Wenn ein Befehl, der in einem Show-Command Fenster ausgeführt wird, standardmäßig einen Fehler generiert, wird der Fehler nur in der Befehlszeile angezeigt.

Wenn Sie den Befehl auch ausführen (indem Sie die Schaltfläche "Ausführen " im Show-Command Fenster verwenden), gibt der ErrorPopup-Parameter die Befehlsergebnisse an den aktuellen Befehl zurück, anstatt den Befehl auszuführen und die Ausgabe an einen neuen Befehl zurückzugeben. Mit dieser Funktion können Sie die Ergebnisse des Befehls in einer Variablen speichern.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Height

Gibt die Höhe des Show-Command Fensters in Pixeln an. Geben Sie einen Wert zwischen 300 und der Anzahl der Pixel in der Bildschirmauflösung ein. Wenn der Wert zu groß ist, um das Befehlsfenster auf dem Bildschirm anzuzeigen, Show-Command wird ein Fehler generiert. Die Standardhöhe ist 600 Pixel. Bei einem Show-Command Befehl, der den Parameter Name enthält, beträgt die Standardhöhe 300 Pixel.

Type:Double
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Zeigt ein Befehlsfenster für den angegebenen Befehl an. Geben Sie den Namen eines Befehls ein, z. B. den Namen eines Cmdlets, einer Funktion oder eines CIM-Befehls. Wenn Sie diesen Parameter auslassen, wird ein Befehlsfenster angezeigt, in dem alle PowerShell-Befehle in allen Modulen aufgelistet werden, Show-Command die auf dem Computer installiert sind.

Type:String
Aliases:CommandName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NoCommonParameter

Gibt an, dass dieses Cmdlet den Abschnitt "Allgemeine Parameter" der Befehlsanzeige ausgelassen. Standardmäßig werden die allgemeinen Parameter in einem erweiterbaren Abschnitt unten im Befehlsfenster angezeigt.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert. Um die Befehlszeichenfolge auszuführen, kopieren Und einfügen Sie sie an der Eingabeaufforderung, oder speichern Sie sie in einer Variablen, und verwenden Sie das Invoke-Expression Cmdlet, um die Zeichenfolge in der Variablen auszuführen.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Width

Gibt die Breite des Show-Command Fensters in Pixeln an. Geben Sie einen Wert zwischen 300 und der Anzahl der Pixel in der Bildschirmauflösung ein. Wenn der Wert zu groß ist, um das Befehlsfenster auf dem Bildschirm anzuzeigen, Show-Command wird ein Fehler generiert. Die Standardbreite ist 300 Pixel.

Type:Double
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Sie können keine Eingabe an Show-Command.

Ausgaben

None, System.String, System.Object

Wenn Sie den PassThru-Parameter verwenden, Show-Command wird eine Befehlszeichenfolge zurückgegeben. Wenn Sie den ErrorPopup-Parameter verwenden, Show-Command wird die Befehlsausgabe (beliebiges Objekt) zurückgegeben. Show-Command Andernfalls wird keine Ausgabe generiert.

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Show-Command funktioniert nicht in Remotesitzungen.