Show-Command

Referenz

Modul:: Microsoft.PowerShell.Utility

Erstellt Windows PowerShell-Befehle in einem grafischen Befehlsfenster.

Syntax

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

Beschreibung

Mit dem Cmdlet Show-Command können Sie einen Windows 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 kann für alle Befehlstypen, einschließlich Cmdlets, Funktionen, Workflows und CIM-Befehle, verwendet werden.

Ohne Parameter zeigt Show-Command ein Befehlsfenster an, in dem alle verfügbaren Befehle in allen installierten Modulen aufgeführt werden. 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 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 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. an die Windows 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 Windows PowerShell Integrated Scripting Environment (ISE) wird standardmäßig eine Variante des Fensters Show-Command angezeigt. Informationen zur Verwendung dieses Befehlsfensters finden Sie in den Windows PowerShell HILFEthemen.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Öffnen des Befehlsfensters

PS C:\> Show-Command

Dieser Befehl zeigt die Standardansicht des Show-Command-Fensters. Im Fenster Befehle wird eine Liste aller Befehle in allen Modulen angezeigt, die auf dem Computer installiert sind.

Beispiel 2: Öffnen eines Cmdlets im Fenster Befehle

PS C:\> Show-Command -Name "Invoke-Command"

Mit diesem Befehl wird das cmdlet Invoke-Command im Fenster Show-Command geöffnet. Sie können die Invoke-Command-Anzeige verwenden, um Invoke-Command-Befehle auszuführen.

Beispiel 3: Öffnen eines Cmdlets mit angegebenen Parametern

PS C:\> Show-Command -Name "Connect-PSSession" -Height 700 -Width 1000 -ErrorPopup

Mit diesem Befehl wird das Fenster Show-Command für das Cmdlet Connect-PSSession geöffnet. Er verwendet die Height- und Width-Parameter, um die Abmessungen des Befehlsfensters anzugeben, und den ErrorPopup-Parameter, um das Fehler-Befehlsfenster anzuzeigen.

Beim Klicken auf Run wird der Befehl Connect-PSSession ausgeführt, ganz so als wenn Sie den Befehl Connect-PSSession in die Befehlszeile eingegeben hätten.

Beispiel 4: Angeben neuer Standardwerte für ein Cmdlet

PS C:\> $PSDefaultParameterValues = @{"Show-Command:Height" = 700; "Show-Command:Width" = 1000; "Show-Command:ErrorPopup" = $True}

Dieser Befehl verwendet die automatische Variable $PSDefaultParameterValues zum Festlegen von neuen Standardwerten für die Height-, Width- und ErrorPopup-Parameter des Cmdlets Show-Command. Wenn Sie jetzt einen Befehl Show-Command ausführen, werden die Standardwerte automatisch angewendet.

Um diese Standardwerte in jeder Windows PowerShell-Sitzung zu verwenden, fügen Sie die $PSDefaultParameterValues-Variable dem Windows PowerShell-Profil hinzu. Weitere Informationen finden Sie unter about_Profiles und about_Parameters_Default_Values.

Beispiel 5: Senden einer Ausgabe an eine Rasteransicht

PS C:\> Show-Command Get-ChildItem | Out-GridView

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

Der Befehl verwendet das Cmdlet Show-Command , um ein Befehlsfenster für das Cmdlet Get-ChildItem zu öffnen. Beim Klicken auf die Schaltfläche Run wird der Befehl Get-ChildItem ausgeführt und generiert eine 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 Fenster Befehle erstellen

PS C:\> Show-Command -PassThru
Get-EventLog -LogName "Windows PowerShell" -Newest 5

Dieser Befehl zeigt den Befehl, den Sie im Fenster Show-Command erstellt haben. Der Befehl verwendet den PassThru-Parameter , der das Show-Command-Ergebnis in einer Zeichenfolge zurückgibt.

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

Wenn Sie sich die Befehlszeichenfolge anschauen, erfahren Sie mehr über Windows PowerShell.

Beispiel 7: Speichern eines Befehls in einer Variablen

PS C:\> $C = Show-Command -PassThru

This command displays the command string in the $C variable.
PS C:\> $C
Get-EventLog -LogName "Windows PowerShell" -Newest 5

These commands use the Invoke-Expression cmdlet to run the string in the $C variable. The first command uses the full cmdlet name. The second command uses the "iex" alias for the **Invoke-Expression** cmdlet. These commands are equivalent and you can use them interchangeably.The output shows the five newest events in the Windows PowerShell event log.
PS C:\> Invoke-Expression $C

PS C:\> iex $C
   Index Time          EntryType   Source                 InstanceID Message
   ----- ----          ---------   ------                 ---------- -------
   11520 Dec 16 16:37  Information PowerShell                    400 Engine state is changed from None to Available....
   11519 Dec 16 16:37  Information PowerShell                    600 Provider "Variable" is Started. ...
   11518 Dec 16 16:37  Information PowerShell                    600 Provider "Registry" is Started. ...
   11517 Dec 16 16:37  Information PowerShell                    600 Provider "Function" is Started. ...
   11516 Dec 16 16:37  Information PowerShell                    600 Provider "FileSystem" is Started. ...

Dieser Befehl zeigt, 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.

Der erste Befehl verwendet den PassThru-Parameter des Show-Command-Cmdlets. Die Ergebnisse des Befehls werden in der variablen $C gespeichert.

Der Befehl öffnet das Fenster Show-Command . In diesem Fall verwenden wir das Fenster Show-Command, um einen Get-EventLog-Befehl zu erstellen, mit dem die fünf neuesten Ereignisse im Windows PowerShell Ereignisprotokoll abgerufen werden. Wenn Sie auf OK klicken, gibt Show-Command die Befehlszeichenfolge zurück, die in der variablen $C gespeichert wird.

Beispiel 8: Speichern der Ausgabe eines Befehls in einer Variablen

PS C:\> $P = Show-Command Get-Process -ErrorPopup

The second command displays the value in the $P variable.
PS C:\> $P
Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName

-------  ------    -----      ----- -----   ------     -- -----------

    473      33    94096     112532   709     2.06   4492 powershell

Diese Befehle verwenden den ErrorPopup-Parameter des Show-Command-Cmdlets, um die Ausgabe eines Befehls in einer Variablen zu speichern.

Der erste Befehl führt das Show-Command-Cmdlet mit dem ErrorPopup-Parameter aus. 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 Fenster Show-Command geöffnet. Mithilfe der Funktionen des Fensters können Sie Parameterwerte festlegen. Um den Befehl auszuführen, klicken Sie auf die Schaltfläche Run im Fenster Show-Command.

Parameter

-ErrorPopup

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

Wenn Sie den Befehl ausführen (mithilfe der Schaltfläche Run im Fenster Show-Command) gibt der ErrorPopup-Parameter zudem die Ergebnisse des Befehls 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:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Height

Gibt die Höhe des Fensters Show-Command 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 ist 600 Pixel. Bei einem Show-Command-Befehl, der den Name-Parameter umfasst, ist die Standardhöhe 300 Pixel.

Type:	Double
Position:	Named
Default value:	None
Required:	False
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, eines Workflows oder eines CIM-Befehls. Wenn Sie diesen Parameter weglassen, zeigt Show-Command ein Befehlsfenster an, in dem alle Windows PowerShell-Befehle in allen Modulen, die auf dem Computer installiert sind, aufgeführt werden.

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

-NoCommonParameter

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	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 Sie sie, und fügen Sie sie in die Eingabeaufforderung ein, oder speichern Sie sie in einer Variablen, und verwenden Sie das Cmdlet „Invoke-Expression“, um die Zeichenfolge in der Variablen auszuführen.

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

-Width

Gibt die Breite des Fensters Show-Command 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 ist 300 Pixel.

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

Eingaben

None

Sie können keine Eingabe an Show-Command übergeben.

Ausgaben

System.String, System.Object

Wenn Sie den PassThru-Parameter verwenden, gibt Show-Command eine Befehlszeichenfolge zurück. Wenn Sie den ErrorPopup-Parameter verwenden, gibt Show-Command die Ausgabe des Befehls (alle Objekte) zurück. Andernfalls generiert Show-Command keine Ausgabe.

Hinweise

Show-Command funktioniert nicht in Remotesitzungen.

Freigeben über