Uso de la finalización de tabulación en el shell

PowerShell proporciona finalizaciones en la entrada para proporcionar sugerencias, habilitar la detección y acelerar la entrada. Los nombres de comandos, los nombres de parámetros, los valores de argumento y las rutas de acceso de archivo se pueden completar presionando la tecla Tab .

La clave Tab es el enlace de clave predeterminado en Windows. PSReadLine también proporciona una función enlazada a CtrlEspacio. La función muestra una lista de finalizaciones coincidentes debajo de la línea de comandos.

Las combinaciones de teclas se pueden cambiar mediante los cmdlets de PSReadLine o la aplicación que hospeda PowerShell. Los enlaces de claves pueden ser diferentes en plataformas que no son de Windows. Para obtener más información, consulte about_PSReadLine_Functions.

Características de finalización de pestañas integradas

PowerShell habilita la finalización de pestañas para muchos aspectos de la experiencia de la línea de comandos.

Finalización del nombre de archivo

Para rellenar automáticamente un nombre de archivo o una ruta de acceso desde las opciones disponibles, escriba parte del nombre y presione la tecla Tab. PowerShell expande automáticamente el nombre a la primera coincidencia que encuentra. Al presionar la tecla Tab de nuevo, se recorren todas las opciones disponibles con cada pulsación de tecla.

Finalización del nombre del comando y del parámetro

La expansión de pestañas de nombres de cmdlet es ligeramente diferente. Para usar la expansión de pestañas en un nombre de cmdlet, escriba la primera parte completa del nombre (verbo) y el guion que aparece detrás. Puede seguir rellenando el nombre para obtener una coincidencia parcial. Por ejemplo, si escribe y, a continuación, presiona la tecla Tab, PowerShell expande automáticamente lo que ha escrito al cmdlet (tenga en cuenta que también cambia las mayúsculas y minúsculas a su forma estándar). Si vuelve a presionar la tecla Tab , PowerShell lo reemplaza por el siguiente cmdlet coincidente, . La finalización de tabulación también funciona para resolver alias de PowerShell y ejecutables nativos.

En el gráfico siguiente se muestran ejemplos de finalización de pestañas y menús.

Ejemplos de finalización de pestañas y menús

Otras mejoras de finalización de pestañas

Cada nueva versión de PowerShell incluye mejoras en la finalización de pestañas que corrigen errores y mejoran la facilidad de uso.

PowerShell 7.0

• La finalización de tabulación resuelve las asignaciones de variables que son enumeraciones o están restringidas de tipo.
• La función de completar con tabulación expande los cmdlets y funciones abreviadas. Por ejemplo, devuelve

PowerShell 7.2

• Corrección de la finalización de pestañas para artículos no localizados
• Corregir el uso incorrecto de splatting tratado como parámetro posicional en autocompletado
• Añadir compleciones para palabras clave de ayuda basada en comentarios
• Adición de finalización de instrucciones
• Agregar finalización de tabulación para parámetro View de cmdlets
• Adición de compatibilidad con los completadores de argumentos basados en clases

PowerShell 7.3

• Corrección de la finalización de tabulación dentro del bloque de script especificado para
• Se ha agregado la finalización de tabulación para las etiquetas de bucle después y
• Mejora de la finalización de tabla hash en varios escenarios
  • Expansión de parámetros
  • Parámetro arguments para
  • Parámetro FilterHashtable para
  • Parámetro de propiedad para los cmdlets CIM
  • Elimina los duplicados de los escenarios de finalización de miembros.
• Compatibilidad con la finalización de barras diagonales en el recurso compartido de red (ruta de acceso UNC)
• Mejora de la finalización automática de miembros
• Priorizar el uso de completaciones en lugar de enumeraciones para parámetros
• Adición de compatibilidad con la inferencia de tipos para métodos genéricos con parámetros de tipo
• Mejora de la inferencia de tipos y finalizaciones
  • Permite que los métodos se muestren en los resultados de finalización de
  • Impide la finalización de expresiones que devuelven void como ()
  • Permite que los constructores de clase no predeterminados se muestren cuando la finalización de la clase se basa en el AST.

Otras formas de mejorar la finalización de tabulación de los parámetros de comando

La expansión de tabulación integrada se controla mediante la función interna TabExpansion o TabExpansion2. Es posible crear funciones o módulos que reemplacen el comportamiento predeterminado de estas funciones. Puede encontrar ejemplos en el Galería de PowerShell buscando la palabra clave TabExpansion.

Uso de los atributos o con parámetros

El atributo permite agregar valores de finalización de tabulación a un parámetro específico. El atributo es similar a . Ambos atributos toman una lista de valores que se van a presentar cuando el usuario presiona Tab después del nombre del parámetro. Sin embargo, a diferencia de , los valores no se validan.

Para obtener más información, consulte:

• Completaciones de Argumentos
• ValidateSet

Uso del atributo o con parámetros

Un completador de argumentos es un bloque de script o una función que proporciona finalización dinámica de tabulación para los valores de parámetro.

El atributo permite registrar una función que proporciona valores de finalización de tabulación para el parámetro . La función de completador de argumentos debe estar disponible para la función que contiene el parámetro con el atributo . Normalmente, la función se define en el mismo script o módulo. Para obtener más información, vea ArgumentCompleter.

El cmdlet registra un bloque de script como una función de completador de argumentos en tiempo de ejecución para cualquier comando que especifique. El uso de permite definir completadores de argumentos fuera del script o módulo o para comandos nativos. Para obtener más información, vea Register-ArgumentCompleter.

IntelliSense predictivo en PSReadLine

PSReadLine 2.1.0 introdujo la característica IntelliSense predictiva . IntelliSense predictivo proporciona sugerencias de comandos completos basados en elementos del historial de PSReadLine.

PSReadLine 2.2.2 amplía la potencia de IntelliSense predictivo agregando compatibilidad con módulos de complemento que usan lógica avanzada para proporcionar sugerencias para comandos completos. El módulo Az.Tools.Predictor fue el primer complemento para IntelliSense predictivo. Usa Machine Learning para predecir qué comando Azure PowerShell quiere ejecutar y los parámetros que desea usar.

Las sugerencias predictivas no son sugerencias de finalización mediante la tecla Tab. Se generan a partir de un origen diferente. De forma predeterminada, las sugerencias de predicción aparecen en texto gris después del cursor. Use la clave RightArrow para aceptar la sugerencia. Si presiona la tecla Tab en su lugar, se omitirá la sugerencia y se ofrecerá la siguiente opción de finalización de pestañas.

Para obtener más información, consulte Uso de predictores.