Show-Command

Referencia

Módulo:: Microsoft.PowerShell.Utility

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

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Show-Command 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 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 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 de forma predeterminada una variación de la ventana de Show-Command. 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 ventana Show-Command. 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 cmdlet en la ventana comando de . Puede usar esta pantalla para ejecutar comandos Invoke-Command.

Show-Command -Name "Invoke-Command"

Ejemplo 3: Abrir un cmdlet con parámetros especificados

Este comando abre una ventana de Show-Command para el cmdletConnect-PSSession.

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, se ejecuta el comando Connect-PSSession, como lo haría si hubiera escrito el comando Connect-PSSession 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 variable automática para establecer nuevos valores predeterminados para los parámetros Height, Widthy ErrorPopup parámetros del cmdlet .

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

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 PowerShell, agregue la variable $PSDefaultParameterValues al perfil de PowerShell. Para obtener más información, vea 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 cmdlets Show-Command y Out-GridView juntos.

Show-Command Get-ChildItem | Out-GridView

El comando usa el cmdlet Show-Command para abrir una ventana de comandos para el cmdletGet-ChildItem. Al hacer clic en el botón Ejecutar , el comando 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 la salida Get-ChildItem 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 ventana Show-Command. El comando usa el parámetro PassThru, que devuelve el Show-Command da como resultado una cadena.

Show-Command -PassThru

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

Por ejemplo, si usa la ventana Show-Command para crear un comando Get-EventLog 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 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 cmdlet y guarda los resultados del comando en la variable . En este caso, usamos la ventana Show-Command para crear un comando Get-EventLog que obtiene los cinco eventos más recientes del 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.

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 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 de Show-Command.

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 ventana de Show-Command 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 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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Height

Especifica el alto de la ventana Show-Command 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 de 600 píxeles. Para un comando Show-Command que incluya el parámetro Name, el alto predeterminado es de 300 píxeles.

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Alias:	CommandName
Posición:	0
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida. 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 cmdlet Invoke-Expression para ejecutar la cadena en la variable.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Width

Especifica el ancho de la ventana de Show-Command 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 de 300 píxeles.

Tipo:	Double
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Compartir a través de