Show-Command

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

Mit dem Cmdlet Show-Command können Sie einen Windows 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 Lernwerkzeug. 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 den PassThru-Parameter auch 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, in der alle Befehle angezeigt werden, drücken Sie STRG, und klicken Sie auf den ausgewählten Befehl.

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

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

PS C:\> Show-Command

Mit diesem Befehl 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.

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

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

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

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

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

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

Mit diesem Befehl wird die automatische Variable $PSDefaultParameterValues verwendet, um neue Standardwerte für die Parameter Height, Width und ErrorPopup des Cmdlets Show-Command festzulegen. Wenn Sie jetzt einen Show-Command-Befehl ausführen, werden die neuen Standardwerte automatisch angewendet.

Wenn Sie diese Standardwerte in jeder Windows PowerShell-Sitzung verwenden möchten, fügen Sie Ihrem Windows PowerShell-Profil die Variable $PSDefaultParameterValues hinzu. Weitere Informationen finden Sie unter about_Profiles und about_Parameters_Default_Values.

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

Dieser Befehl zeigt, wie die Cmdlets Show-Command und Out-GridView zusammen verwendet werden.

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

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

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

Wenn Sie z. B. 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.

Das Anzeigen der Befehlszeichenfolge hilft Ihnen beim Erlernen von Windows PowerShell.

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 Cmdlets Show-Command verwenden. Mit dieser Strategie können Sie den Befehl anzeigen und verwenden.

Im ersten Befehl wird der PassThru-Parameter des Cmdlets Show-Command verwendet. Die Ergebnisse des Befehls werden in der Variablen $C gespeichert.

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

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 Parameter ErrorPopup des Cmdlets Show-Command, um die Ausgabe eines Befehls in einer Variablen zu speichern.

Mit dem ersten Befehl wird das Cmdlet Show-Command mit dem Parameter ErrorPopup ausgeführt. 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 Fenster Show-Command geöffnet. Sie können die Fensterfeatures verwenden, um Parameterwerte festzulegen. Um den Befehl auszuführen, klicken Sie im Fenster Show-Command auf die Schaltfläche Ausführen.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben können nicht über die Pipeline an Show-Command übergeben werden.

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

• Show-Command funktioniert nicht in Remote-Sitzungen.