Show-Command

Referenz

Modul:: Microsoft.PowerShell.Utility

Zeigt PowerShell-Befehlsinformationen in einem grafischen Fenster an.

Syntax

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

Beschreibung

Mit dem Cmdlet Show-Command können Sie einen PowerShell-Befehl in einem Befehlsfenster erstellen. Sie können die Features des Befehlsfensters verwenden, um den Befehl auszuführen oder den Befehl an Sie zurückzugeben.

Show-Command ist ein sehr nützliches Lehr- und Lerntool. Show-Command funktioniert für alle Befehlstypen, einschließlich Cmdlets, Funktionen, Workflows und CIM-Befehle.

Ohne Parameter zeigt Show-Command ein Befehlsfenster an, in dem alle verfügbaren Befehle in allen installierten Modulen aufgelistet sind. Um die Befehle in einem Modul zu finden, wählen Sie das Modul aus der Dropdownliste "Module" aus. Um einen Befehl auszuwählen, klicken Sie 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 liste Befehle. 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 dem Dropdownfeld aus. Wenn Sie einen Switch-Parameter hinzufügen möchten, klicken Sie, um das Kontrollkästchen für den Parameter zu aktivieren.

Wenn Sie fertig sind, können Sie auf Kopieren klicken, um den Befehl zu kopieren, den Sie in die Zwischenablage erstellt haben, oder klicken Sie auf Ausführen, 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, in der alle Befehle angezeigt werden, drücken Sie STRG, und klicken Sie auf den ausgewählten Befehl.

In der integrierten PowerShell 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 3.0 eingeführt.

Da für dieses Cmdlet eine Benutzeroberfläche erforderlich ist, funktioniert es nicht unter 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. Im Fenster Befehle wird eine Liste aller Befehle in allen Modulen angezeigt, die auf dem Computer installiert sind.

Show-Command

Beispiel 2: Öffnen eines Cmdlets im Befehlsfenster

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

Show-Command -Name "Invoke-Command"

Beispiel 3: Öffnen eines Cmdlets mit angegebenen Parametern

Mit diesem Befehl wird ein Show-Command Fenster für das CmdletConnect-PSSessiongeöffnet.

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

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

Wenn Sie auf Ausführenklicken, wird der befehl Connect-PSSession genauso ausgeführt, wie wenn Sie den Befehl Connect-PSSession 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, Widthund ErrorPopup Parameter des Cmdlets Show-Command 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 der PowerShell-Profil die $PSDefaultParameterValues Variable 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 cmdlets Show-Command und Out-GridView gemeinsam verwenden.

Show-Command Get-ChildItem | Out-GridView

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

Beispiel 6: Anzeigen eines Befehls, den Sie im Befehlsfenster erstellen

Dieses Beispiel zeigt den Befehl, den Sie im fenster Show-Command erstellt haben. Der Befehl verwendet den PassThru--Parameter, der die Show-Command ergebnis in einer Zeichenfolge zurückgibt.

Show-Command -PassThru

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

Wenn Sie z. B. das Show-Command-Fenster verwenden, um einen Get-EventLog Befehl zu erstellen, der die fünf neuesten Ereignisse im Windows PowerShell-Ereignisprotokoll abruft, und klicken Sie dann auf OK, gibt der Befehl 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 Cmdlets Show-Command verwenden. Mit dieser Strategie können Sie den Befehl anzeigen und 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 cmdlets Show-Command 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 OKklicken, gibt Show-Command die Befehlszeichenfolge zurück, die in der variablen $C 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

Neben der Anzeige von Fehlern in einem Fenster gibt ErrorPopup Befehlsausgabe 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. Sie können die Fensterfeatures verwenden, um Parameterwerte festzulegen. Klicken Sie zum Ausführen des Befehls im fenster Show-Command auf die Schaltfläche Ausführen.

Parameter

-ErrorPopup

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

Wenn Sie den Befehl ausführen (mithilfe der Schaltfläche Ausführen im Fenster Show-Command), gibt der ErrorPopup Parameter die Befehlsergebnisse an den aktuellen Befehl zurück, anstatt den Befehl auszuführen und seine Ausgabe an einen neuen Befehl zurückzugeben. Sie können dieses Feature verwenden, um die Befehlsergebnisse in einer Variablen zu speichern.

Typ:	SwitchParameter
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Height

Gibt die Höhe des Show-Command Fensters in Pixel 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, generiert Show-Command einen Fehler. Die Standardhöhe beträgt 600 Pixel. Bei einem Show-Command Befehl, der den Parameter Name enthält, beträgt die Standardhöhe 300 Pixel.

Typ:	Double
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 weglassen, zeigt Show-Command ein Befehlsfenster an, in dem alle PowerShell-Befehle in allen auf dem Computer installierten Modulen aufgelistet sind.

Typ:	String
Aliase:	CommandName
Position:	0
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NoCommonParameter

Gibt an, dass dieses Cmdlet den Abschnitt "Allgemeine Parameter" der Befehlsanzeige ausgelassen. Standardmäßig werden die allgemeinen Parameter in einem erweiterbaren Abschnitt am unteren Rand des Befehlsfensters angezeigt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Width

Gibt die Breite des Show-Command-Fensters in Pixel 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, generiert Show-Command einen Fehler. Die Standardbreite beträgt 300 Pixel.

Typ:	Double
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

String

Wenn Sie den PassThru Parameter verwenden, gibt dieses Cmdlet eine Befehlszeichenfolge zurück.

Object

Wenn Sie den ErrorPopup Parameter verwenden, gibt dieses Cmdlet die Befehlsausgabe (jedes Objekt) zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Show-Command:

shcm

Show-Command funktioniert in Remotesitzungen nicht.

Freigeben über