Show-Command

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Muestra información de comandos de PowerShell en una ventana gráfica.

Syntax

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Show-Command cmdlet le permite crear un comando de PowerShell en una ventana de comandos. Puede usar las características de la ventana de comandos para ejecutar el comando o para que esta 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 encontrar los comandos en un módulo, seleccione el módulo de 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 . 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 de modificador, haga clic para activar la casilla 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 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 PowerShell, se muestra una variación de la Show-Command ventana de forma predeterminada. Para obtener información sobre el uso de esta ventana de comandos, consulte los temas de ayuda de PowerShell ISE.

Este cmdlet se ha vuelto a introducir en PowerShell 7.

Dado que este cmdlet requiere una interfaz de usuario, no funciona en Windows Server Core o Windows Nano Server. Este cmdlet solo está disponible en sistemas Windows que admiten el escritorio de Windows.

Ejemplos

Ejemplo 1: Abrir la ventana Comandos

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

Show-Command

Ejemplo 2: Abrir un cmdlet en la ventana Comandos

En este ejemplo se muestra el Invoke-Command cmdlet en la ventana Comando . Puede usar esta pantalla para ejecutar Invoke-Command comandos.

Show-Command -Name "Invoke-Command"

Ejemplo 3: Abrir un cmdlet con parámetros especificados

Este comando abre una Show-Command ventana para elConnect-PSSessioncmdlet .

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

Los parámetros Height y Width especifican la dimensión de la ventana de comandos. El parámetro ErrorPopup muestra la ventana de comandos de error.

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

Ejemplo 4: Especificación de nuevos valores de parámetro predeterminados para un cmdlet

En este ejemplo se usa la $PSDefaultParameterValues variable automática para establecer nuevos valores predeterminados para los parámetros Height, Width y ErrorPopup del Show-Command cmdlet .

$PSDefaultParameterValues = @{
    "Show-Command:Height" = 700
    "Show-Command:Width" = 1000
    "Show-Command:ErrorPopup" = $True
}

Ahora, al ejecutar un Show-Command comando, los nuevos valores predeterminados se aplican automáticamente. Para usar estos valores predeterminados en cada sesión de PowerShell, agregue la $PSDefaultParameterValues variable al perfil de PowerShell. Para obtener más información, consulte about_Profiles y about_Parameters_Default_Values.

Ejemplo 5: Envío de salida a una vista de cuadrícula

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

Show-Command Get-ChildItem | Out-GridView

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

Ejemplo 6: Mostrar un comando que se crea en la ventana Comandos

En este ejemplo se muestra el comando que creó en la Show-Command ventana. El comando usa el parámetro PassThru , que devuelve los Show-Command resultados en una cadena.

Show-Command -PassThru

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

Por ejemplo, si usa la Show-Command ventana para crear un Get-EventLog comando que obtiene los cinco eventos más recientes del registro de eventos de Windows PowerShell y, a continuación, hace clic en Aceptar, el comando devuelve la salida mostrada anteriormente. Ver la cadena de comandos le ayuda a aprender PowerShell.

Ejemplo 7: Guardar un comando en una variable

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

$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. ...

El primer comando usa el parámetro PassThru del Show-Command cmdlet y guarda los resultados del comando en la $C variable . En este caso, usamos la Show-Command ventana para crear un Get-EventLog comando que obtiene 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 $C variable .

Ejemplo 8: Guardar la salida de un comando en una variable

En este ejemplo se usa el parámetro ErrorPopup para guardar la salida de un comando en una variable.

$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

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 Show-Command ventana. Puede usar las características de la ventana para establecer los valores de los parámetros. Para ejecutar el comando, haga clic en el botón Ejecutar de la Show-Command ventana.

Parámetros

-ErrorPopup

Indica que el cmdlet muestra errores en una ventana emergente, además de mostrarlos en la línea de comandos. De forma predeterminada, cuando un comando que se ejecuta en una Show-Command ventana genera un error, el error solo se muestra en la línea de comandos.

Además, al ejecutar el comando (mediante el botón Ejecutar en la Show-Command ventana), el parámetro ErrorPopup devuelve los resultados del comando al comando actual, en lugar de ejecutar el comando y devolver su salida a un nuevo comando. Puede usar esta característica para guardar los resultados del comando en una variable.

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

-Height

Especifica el alto de la Show-Command ventana en píxeles. Escriba un valor entre 300 y el número de píxeles en la resolución de pantalla. Si el valor es demasiado grande para mostrar la ventana de comandos en la pantalla, Show-Command genera un error. El alto predeterminado es 600 píxeles. Para un Show-Command comando que incluya el parámetro Name , el alto predeterminado es de 300 píxeles.

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

-Name

Muestra una ventana de comandos para el comando especificado. Escriba el nombre de un comando, como el nombre de un cmdlet, una función o un comando CIM. Si omite este parámetro, Show-Command muestra una ventana de comandos que muestra todos los comandos de PowerShell en todos los módulos instalados en el equipo.

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

-NoCommonParameter

Indica que este cmdlet omite la sección Parámetros comunes de la presentación del comando. De forma predeterminada, los parámetros comunes aparecen en una sección expandible en la parte inferior de la ventana de comandos.

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

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado. Para ejecutar la cadena de comandos, copie y péguela en el símbolo del sistema o guárdela en una variable y use el Invoke-Expression cmdlet para ejecutar la cadena en la variable.

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

-Width

Especifica el ancho de la Show-Command ventana en píxeles. Escriba un valor entre 300 y el número de píxeles en la resolución de pantalla. Si el valor es demasiado grande para mostrar la ventana de comandos en la pantalla, Show-Command genera un error. El ancho predeterminado es 300 píxeles.

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

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

String

Cuando se usa el parámetro PassThru , este cmdlet devuelve una cadena de comandos.

Object

Cuando se usa el parámetro ErrorPopup , este cmdlet devuelve la salida del comando (cualquier objeto).

Notas

PowerShell incluye los siguientes alias para Show-Command:

  • Windows:
    • shcm

Este cmdlet solo está disponible en plataformas Windows.

Show-Command no funciona en sesiones remotas.