Compartir a través de

Configuración del perfil general en Terminal Windows

  • Artículo

Los valores que se muestran a continuación son específicos de cada perfil. Si quiere que una configuración se aplique a todos los perfiles, puede agregarla a la sección defaults, encima de la lista de perfiles del archivo settings.json.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Ordenación de perfiles

El orden de los perfiles en "list" determina la numeración del índice de perfil. Se usa para asignar al combo de teclas de inicio, como Ctrl+Mayús+1. Para cambiar el número del índice de perfil, simplemente corta o pega los objetos de perfil encima o debajo entre ellos. El primero en "list" se asignará al índice 1, por lo que se asignará al combo de teclas, Ctrl+Mayús+1.

Nombre

Nombre del perfil que se mostrará en el menú desplegable. Este valor también se usa como "título" para pasar al shell en el inicio. Algunos shells (como bash) pueden optar por omitir este valor inicial, mientras que otros (Command Prompt, PowerShell) pueden usar este valor durante la vigencia de la aplicación. Este comportamiento de "título" se puede invalidar mediante tabTitle.

Nombre de la propiedad: name

Necesidad: Requerido

Acepta: Cadena


Línea de comandos

Archivo ejecutable que se usa en el perfil.

Nombre de la propiedad: commandline

Necesidad: Opcional

Acepta: Nombre del archivo ejecutable como una cadena

Valor predeterminado: "cmd.exe"

Ejemplo: Para ejecutar un archivo por lotes cada vez que se ejecuta cmd.exe, establezca este valor en "cmd.exe /k path\to\script.bat"


Directorio inicial

Directorio en el que se inicia el shell cuando se carga.

Nombre de la propiedad: startingDirectory

Necesidad: Opcional

Acepta: Ubicación de la carpeta como una cadena

Valor predeterminado: "%USERPROFILE%"

NOTA: Cuando no se define el directorio inicial, el valor predeterminado se establece en "%USERPROFILE%" (la ruta de acceso relativa a la configuración del usuario, por ejemplo, puede ser C:\Users\<your username>). Pero si el directorio inicial se establece explícitamente en null, obtendrás resultados diferentes en función de dónde inicies el Terminal.

Ejemplo: inicie el perfil de PowerShell en la carpeta GitHubRepos del directorio Documentos buscando el powershell.exe y agregando "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",.

Ejemplo con WSL: al establecer el directorio de inicio para una distribución de Linux instalada a través de WSL, use el formato "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME", reemplazando los marcadores de posición por los nombres adecuados de la distribución. Por ejemplo, "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1". Si usa la interfaz de usuario de configuración de Terminal Windows, en lugar del archivo settings.json, para declarar esta ruta de acceso, puede usar el botón Examinar... para seleccionar el directorio de inicio o escribir la ruta de acceso de WSL como: //wsl.localhost/DISTRO NAME/home/USERNAME. Por ejemplo, //wsl.localhost/Ubuntu-20.04/home/user1.

Comportamiento predeterminado: Cuando no se especifica el valor startingDirectory, se obtienen resultados diferentes en función de dónde inicie Terminal:

  • Si ejecuta el Terminal Windows desde el menú Inicio: %WINDIR%\System32
  • Si ejecuta wt.exe desde el menú Inicio: %WINDIR%\System32
  • Si ejecuta wt.exe desde Win+R: %USERPROFILE%
  • Si ejecuta wt.exe desde la barra de direcciones del explorador: la carpeta que estaba mirando.

Nota

Las barras diagonales inversas deben ser de escape. Por ejemplo, C:\Users\USERNAME\Documents debe cambiarse a C:\\Users\\USERNAME\\Documents.

Icono

Esto establece el icono que se muestra en la pestaña, el menú desplegable, la lista de accesos directos y el modificador de pestañas.

Nombre de la propiedad: icon

Necesidad: Opcional

Acepta: ubicación del archivo como cadena o emoji

Ejemplo: al colocar la imagen de icono ubuntu.ico en la carpeta ubicada en %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState, puede mostrar el icono si agrega esta línea al perfil en el archivo settings.json: "icon": "ms-appdata:///roaming/ubuntu.ico".


___

Título de la pestaña

Si se establece, reemplazará name como el título que se va a pasar al shell al iniciarse. Algunos shells (como bash) pueden optar por omitir este valor inicial, mientras que otros (Command Prompt, PowerShell) pueden usar este valor durante la vigencia de la aplicación. Si quiere más información sobre cómo hacer que el shell configure el título, consulte el tutorial sobre el título de la pestaña.

Nombre de la propiedad: tabTitle

Necesidad: opcional

Acepta: Cadena


___

Ejecutar como administrador automáticamente

Si se establece, este perfil se abrirá automáticamente en una ventana "con privilegios elevados" (en ejecución como administrador) de forma predeterminada. Si ejecuta este perfil desde una ventana sin privilegios elevados, se creará una nueva ventana de terminal con privilegios elevados para hospedar este perfil. Si inicia este perfil desde una ventana que ya tiene privilegios elevados, se abrirá como una nueva pestaña.

Cuando esta propiedad se establece en false, al abrir este perfil en una ventana con privilegios elevados, no se abrirá una ventana sin privilegios elevados para hospedar este perfil. El perfil simplemente se abrirá en la ventana con privilegios elevados y se ejecutará como administrador.

Si establece esta propiedad en profiles.defaults, todos los perfiles se iniciarán como administrador de manera predeterminada, a menos que esta opción se configure específicamente en false para invalidarla.

Esta propiedad se puede invalidar en las acciones newTab y splitPane, con la propiedad elevate.

Las pestañas con privilegios elevados y sin estos no pueden existir en la misma ventana de terminal. Para obtener más información, consulte Preguntas frecuentes.

Nombre de la propiedad: elevate

Necesidad: opcional

Acepta: true, false

Valor predeterminado: false


___

Ocultar perfil de la lista desplegable

Si hidden está establecido en true, el perfil no aparecerá en la lista de perfiles. Se puede usar para ocultar perfiles predeterminados y perfiles generados dinámicamente, presentes en el archivo de configuración. Para obtener más información sobre los perfiles dinámicos, visite la página Perfiles dinámicos.

Nombre de la propiedad: hidden

Necesidad: opcional

Acepta: true, false

Valor predeterminado: false