Show-Command

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

El cmdlet show-command le permite crear un comando de Windows PowerShell en una ventana de comandos. Puede usar las características de la ventana de comandos para ejecutar el comando o hacer que devuelva el comando.

Show-Command es una herramienta de enseñanza y aprendizaje muy útil. Show-Command funciona en todos los tipos de comandos, incluidos cmdlets, funciones, flujos de trabajo y comandos CIM.

Sin parámetros, Show-Command muestra una ventana de comandos que muestra todos los comandos disponibles en todos los módulos instalados. Para buscar los comandos de un módulo, seleccione el módulo en la lista desplegable Módulos. Para seleccionar un comando, haga clic en el nombre del comando.

Para usar la ventana de comandos, seleccione un comando, ya sea mediante el nombre o haciendo clic en el nombre del comando en la lista comandos de . Cada conjunto de parámetros se muestra en una pestaña independiente. Los asteriscos indican los parámetros obligatorios. Para especificar valores para un parámetro, escriba el valor en el cuadro de texto o seleccione el valor en el cuadro desplegable. Para agregar un parámetro switch, haga clic para activar la casilla de verificación del parámetro .

Cuando esté listo, puede hacer clic en Copiar para copiar el comando que ha creado en el Portapapeles o hacer clic en Ejecutar para ejecutar el comando. También puede usar el parámetro PassThru para devolver el comando al programa host, como la consola de Windows PowerShell. Para cancelar la selección de comandos y volver a la vista que muestra todos los comandos, presione Ctrl y haga clic en el comando seleccionado.

En el entorno de scripting integrado (ISE) de Windows PowerShell, se muestra de forma predeterminada una variación de ventana Show-Command. Para obtener información sobre el uso de esta ventana de comandos, consulte los temas de ayuda de Windows PowerShell ISE.

Este cmdlet se introdujo en Windows PowerShell 3.0.

PS C:\> Show-Command

Este comando muestra la vista predeterminada de la ventana Show-Command. La ventana Comandos muestra una lista de todos los comandos de todos los módulos instalados en el equipo.

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

Este comando abre la presentación del cmdlet Invoke-Command en la ventana Show-Command. Puede usar la pantalla Invoke-Command para ejecutar comandos Invoke-Command .

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

Este comando abre una ventana Show-Command para el cmdlet Connect-PSSession. Usa los parámetros height y Width para especificar la dimensión de la ventana de comandos y el parámetro ErrorPopup para mostrar la ventana de comandos de error.

Al hacer clic en Ejecutar, se ejecuta el comando Connect-PSSession, como lo haría si hubiera escrito el comando connect-PSSession en la línea de comandos.

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

Este comando usa la variable automática $PSDefaultParameterValues para establecer nuevos valores predeterminados para elheight de , widthy parámetros errorPopup del cmdlet Show-Command de . Ahora, al ejecutar un comando Show-Command, los nuevos valores predeterminados se aplican automáticamente.

Para usar estos valores predeterminados en cada sesión de Windows PowerShell, agregue la variable $PSDefaultParameterValues al perfil de Windows PowerShell. Para obtener más información, vea about_Profiles y about_Parameters_Default_Values.

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

Este comando muestra cómo usar los cmdlets Show-Command y Out-GridView juntos.

El comando usa el cmdlet Show-Command para abrir una ventana de comandos para el cmdlet Get-ChildItem. Al hacer clic en el botón ejecutar de , el comando Get-ChildItem se ejecuta y genera la salida. El operador de canalización ( | ) envía la salida del comando Get-ChildItem al cmdlet Out-GridView, que muestra el de Get-ChildItem en una ventana interactiva.

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

Este comando muestra el comando que creó en la ventana Show-Command. El comando usa el parámetro PassThru, que devuelve el Show-Command da como resultado una cadena.

Por ejemplo, si usa la ventana Show-Command para crear un comando Get-EventLog que obtenga los cinco eventos más recientes del registro de eventos de Windows PowerShell y, a continuación, haga clic en Aceptar, el comando devuelve la salida siguiente.

Ver la cadena de comandos le ayuda a aprender 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. ...

Este comando muestra cómo ejecutar la cadena de comandos que se obtiene al usar el parámetro passThru del cmdlet Show-Command de . Esta estrategia le permite ver el comando y usarlo.

El primer comando usa el parámetro PassThru del cmdlet Show-Command. Guarda los resultados del comando en la variable $C.

El comando abre una ventana Show-Command. En este caso, usamos la ventana Show-Command para crear un comando Get-EventLog que obtenga los cinco eventos más recientes en el registro de eventos de Windows PowerShell. Al hacer clic en Aceptar, Show-Command devuelve la cadena de comandos, que se guarda en la variable $C.

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

Estos comandos usan el parámetro errorPopup de cmdlet Show-Command para guardar la salida de un comando en una variable.

El primer comando ejecuta el cmdlet Show-Command con el parámetro ErrorPopup . Además de mostrar errores en una ventana, ErrorPopup devuelve la salida del comando al comando actual, en lugar de crear un nuevo comando.

Al ejecutar este comando, se abre la ventana Show-Command. Puede usar las características de la ventana para establecer valores de parámetro. Para ejecutar el comando, haga clic en el botón ejecutar en la ventana show-command de .

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

No se puede canalizar la entrada a Show-Command.

Cuando se usa el parámetro PassThru, Show-Command devuelve una cadena de comandos. Cuando se usa el parámetro ErrorPopup, Show-Command devuelve la salida del comando (cualquier objeto). De lo contrario, show-command no genera ninguna salida.

• show-command no funciona en sesiones remotas.