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 Show-Command
dem 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 für alle Befehlstypen, einschließlich Cmdlets, Funktionen, Workflows und CIM-Befehlen.
Ohne Parameter wird ein Befehlsfenster angezeigt, Show-Command
in dem alle verfügbaren Befehle in allen installierten Modulen aufgelistet sind. 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, indem Sie entweder den Namen verwenden oder in der Liste Befehle auf den Befehlsnamen klicken. 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 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 PowerShell Integrated Scripting Environment (ISE) wird standardmäßig eine Variation des Show-Command
Fensters angezeigt. Informationen zur Verwendung dieses Befehlsfensters finden Sie in den Hilfethemen zu PowerShell ISE.
Dieses Cmdlet wurde in PowerShell 7 wieder eingeführt.
Da dieses Cmdlet eine Benutzeroberfläche erfordert, 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 Fensters "Befehle"
In diesem Beispiel wird die Standardansicht des Fensters Show-Command
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 Fenster Befehle
In diesem Beispiel wird das Invoke-Command
Cmdlet im Fenster Befehl 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-PSSession
Cmdlet.
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ühren klicken, wird der Connect-PSSession
Befehl genauso ausgeführt, wie wenn Sie den Connect-PSSession
Befehl an der Befehlszeile eingeben würden.
Beispiel 4: Angeben neuer Standardparameterwerte 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 einer Ausgabe an eine Rasteransicht
Dieser Befehl zeigt, wie Sie die Show-Command
Cmdlets und Out-GridView
gemeinsam verwenden.
Show-Command Get-ChildItem | Out-GridView
Der Befehl verwendet das Show-Command
Cmdlet, um ein Befehlsfenster für dasGet-ChildItem
Cmdlet zu öffnen.
Wenn Sie auf die Schaltfläche Ausführen klicken, wird der Get-ChildItem
Befehl ausgeführt und generiert eine 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
Dieses Beispiel zeigt den Befehl, den Show-Command
Sie im 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 Show-Command
Fenster 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 oben gezeigte Ausgabe zurück. Das Anzeigen der Befehlszeichenfolge hilft Ihnen, PowerShell zu 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, Show-Command
gibt die Befehlszeichenfolge zurück, 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 Fenster auf die Show-Command
Schaltfläche Ausführen.
Parameter
-ErrorPopup
Gibt an, dass das Cmdlet Zusätzlich zur Anzeige in der Befehlszeile Fehler in einem Popupfenster anzeigt. Wenn ein Befehl, der in einem Show-Command
Fenster ausgeführt wird, einen Fehler generiert, wird der Fehler standardmäßig nur in der Befehlszeile angezeigt.
Wenn Sie den Befehl ausführen (mithilfe der Schaltfläche Ausführen im Show-Command
Fenster), 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. Mit dieser Funktion können Sie die Ergebnisse des Befehls in einer Variablen speichern.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
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, 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 |
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 oder eines CIM-Befehls. Wenn Sie diesen Parameter weglassen, wird ein Befehlsfenster angezeigt, Show-Command
in dem alle PowerShell-Befehle in allen auf dem Computer installierten Modulen aufgeführt sind.
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: | False |
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 an der Eingabeaufforderung, fügen Sie sie ein, 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 |
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, Show-Command
wird ein Fehler generiert. 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 übergeben Show-Command
.
Ausgaben
None, System.String, System.Object
Wenn Sie den PassThru-Parameter verwenden, Show-Command
gibt eine Befehlszeichenfolge zurück. Wenn Sie den ErrorPopup-Parameter verwenden, Show-Command
gibt die Befehlsausgabe (beliebiges Objekt) zurück. Show-Command
Andernfalls generiert keine Ausgabe.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Show-Command
funktioniert nicht in Remotesitzungen.