Comandos de inicio de sesión y de contexto
Esta página enumera cada argumento y cada opción de los comandos que guardan, seleccionan e inspeccionan sus espacios de trabajo: devo login, devo logout, devo status, devo info y devo context. Para una visión de todos los comandos, consulte Comandos. Para una ayuda paso a paso, consulte Iniciar sesión en Devolutions Cloud, Iniciar sesión en Devolutions Server, Usar un perfil local de Devolutions Remote Desktop Manager y Cambiar entre espacios de trabajo.
Las opciones que acepta cada comando, como --context, --source o --output json, están en Opciones globales.
devo login
Guarda un espacio de trabajo como contexto: inicia sesión en Devolutions Cloud o Devolutions Server, o apunta a la carpeta de un perfil local de Devolutions Remote Desktop Manager. El contexto nuevo pasa a ser el actual, a menos que añada --no-set-current.
Espacio de trabajo: Todos los tipos de espacio de trabajo
devo login <name> --cloud <url> --oauth
devo login <name> --cloud <url> --application-key <key> --application-secret-env <variable>
devo login <name> --server <url> --api-key-env <variable>
devo login <name> --server <url> --username <username> --password-env <variable>
devo login <name> --sqlite <folder>Pase exactamente uno de --cloud, --server o --sqlite. Sin ninguno de ellos, o con más de uno, el comando se detiene antes de contactar con nada.
<name>
Nombre del contexto que se va a crear. Obligatorio. No puede estar vacío. No puede ser un nombre ya usado por un contexto de otro tipo: elija otro nombre, o elimine primero el otro contexto.
--cloud <url>
Dirección de Devolutions Cloud, por ejemplo https://example.devolutions.app. Debe ser una dirección https absoluta sin nombre de usuario ni contraseña; el http simple solo se acepta para una dirección de bucle invertido como localhost. Iniciar sesión de nuevo con el nombre de un contexto existente de Devolutions Cloud lo sustituye.
--server <url>
Dirección de Devolutions Server. Las mismas reglas que --cloud: dirección https absoluta, http solo para una dirección de bucle local, sin nombre de usuario ni contraseña.
--sqlite <folder>
Carpeta del perfil local de Devolutions Remote Desktop Manager que contiene el espacio de trabajo SQLite. Las variables de entorno de la ruta se expanden. No se inicia sesión: el contexto solo apunta a la carpeta. Las opciones de inicio de sesión de abajo se ignoran con --sqlite.
--oauth
Desactivado
Devolutions Cloud o Devolutions Server: inicia sesión por su navegador. Devolutions CLI imprime la dirección de inicio de sesión en la salida de error cada vez, por si el navegador no se abre. Usa una redirección del navegador local, salvo que añada --use-device-code. No se puede combinar con las opciones de clave de aplicación (Devolutions Cloud), ni con una clave de API, un nombre de usuario, una contraseña, un dominio o una opción de usuario de aplicación (Devolutions Server).
--use-device-code
Desactivado
Solo con --oauth: inicia sesión con un código de dispositivo en lugar de la redirección del navegador local, para un ordenador sin navegador. Definir la variable de entorno DEVO_CLI_USE_DEVICE_CODE tiene el mismo efecto. Con Devolutions Cloud, un inicio de sesión con código de dispositivo no obtiene una clave de cuenta, así que solo funcionan devo status y devo logout: inicie sesión sin --use-device-code para un acceso completo. Se rechaza sin --oauth.
--application-key <key> (--app-key)
Solo Devolutions Cloud: clave de aplicación. Obligatoria para un inicio de sesión de Devolutions Cloud sin --oauth. No puede contener caracteres de control. Rechazada con --oauth y con --server.
--application-secret-env <variable> (--app-secret-env)
Solo Devolutions Cloud: nombre de la variable de entorno que contiene el secreto de la aplicación. Use esta opción o --application-secret-file, no ambas. La variable debe existir y su valor no puede estar vacío.
--application-secret-file <path> (--app-secret-file)
Solo Devolutions Cloud: archivo que contiene el secreto de aplicación. Los saltos de línea al final del archivo se ignoran.
--api-key-env <variable>
Solo Devolutions Server: nombre de la variable de entorno que contiene la clave de API. Use esta opción o --api-key-file, no ambas. No se puede combinar con --username, una opción de contraseña, --domain-id o --as-application.
--api-key-file <path>
Solo Devolutions Server: archivo que contiene la clave de API.
--username <username>
Solo Devolutions Server: nombre de usuario, para el inicio de sesión con nombre de usuario y contraseña. Necesita --password-env o --password-file.
--password-env <variable>
Solo Devolutions Server: nombre de la variable de entorno que contiene la contraseña. Use esta opción o --password-file, no ambas. Necesita --username.
--password-file <path>
Solo Devolutions Server: archivo que contiene la contraseña. Necesita --username.
--windows-auth
Desactivado
Solo Devolutions Server: inicia sesión con la autenticación de Windows. Funciona solo en Windows. No se puede combinar con --username, una opción de contraseña, --domain-id o --as-application.
--as-application
Desactivado
Solo Devolutions Server: con --username y una opción de contraseña, inicia sesión como usuario de aplicación.
--domain-id <id>
Solo Devolutions Server: identificador de dominio, para la autenticación de dominio con --username y una opción de contraseña.
--timeout <seconds>
15
Devolutions Cloud y Devolutions Server: tiempo límite de las solicitudes hechas durante el inicio de sesión, de 3 a 600 segundos. Cualquier otro valor se rechaza. El valor no se guarda con el contexto: se aplica solo a este inicio de sesión.
--no-set-current
Desactivado
Guarda el contexto sin convertirlo en el actual. Para un perfil local, el contexto nuevo pasa a ser el actual cuando todavía no hay ningún contexto actual.
--workspace <name>
Solo perfil local: espacio de trabajo predeterminado, guardado con el contexto como indicación para las personas y los agentes. Se rechaza con --cloud o --server.
--vault <name>
Solo perfil local: bóveda predeterminada, guardada con el contexto como indicación para las personas y los agentes. Se rechaza con --cloud o --server.
--description <text>
Solo perfil local: descripción del contexto. Se rechaza con --cloud o --server.
--replace
Desactivado
Solo perfil local: sustituye un contexto de perfil local existente con el mismo nombre. Sin esta opción, ese nombre se rechaza. Se rechaza con --cloud o --server.
Métodos de inicio de sesión de un vistazo
Devolutions Cloud
--oauth (opcionalmente con --use-device-code), o --application-key con --application-secret-env o --application-secret-file.
Devolutions Server
--oauth (opcionalmente con --use-device-code), --api-key-env o --api-key-file, --username con --password-env o --password-file (opcionalmente con --domain-id o --as-application), o --windows-auth. Sin un método de inicio de sesión, o con más de uno, el comando se detiene.
Perfil local
Sin inicio de sesión: --sqlite <folder>, opcionalmente con --workspace, --vault, --description y --replace.
Antes de guardar un contexto de Devolutions Cloud o Devolutions Server, devo login comprueba el inicio de sesión con el espacio de trabajo. Si la comprobación falla, no se guarda nada. Los errores en las propias opciones detienen el comando con el código de salida 2; un inicio de sesión fallido termina con 1. Consulte Códigos de salida y errores.
devo logout
Borra el inicio de sesión almacenado de un contexto de Devolutions Cloud o de Devolutions Server. El propio contexto se conserva: vuelva a iniciar sesión con devo login, o elimínelo con devo context delete.
Espacio de trabajo: Devolutions Cloud, Devolutions Server
<name>
Contexto actual
Contexto del que cerrar sesión. Sin él, se usa el contexto actual; si no hay un contexto actual, el comando se detiene y pide un nombre. Un contexto de perfil local se rechaza, porque no tiene inicio de sesión. Para un inicio de sesión en el navegador, la sesión guardada en el almacén seguro también se elimina.
devo status
Muestra el espacio de trabajo seleccionado: su contexto, su tipo y, para Devolutions Cloud o Devolutions Server, si ha iniciado sesión.
Espacio de trabajo: Todos los tipos de espacio de trabajo
<name>
Espacio de trabajo seleccionado
Contexto que mostrar. Sin él, se muestra el espacio de trabajo seleccionado por --source, --context o el contexto actual. Un nombre desconocido es un error. Para un perfil local, el estado muestra el contexto y su carpeta de perfil. Con --source cloud o --source server y sin nombre de contexto, se usa el contexto actual de ese tipo; si no hay ninguno, el estado dice que no ha iniciado sesión en lugar de fallar.
--online
Desactivado
Devolutions Cloud y Devolutions Server: contacta con el espacio de trabajo para comprobar que el inicio de sesión sigue funcionando. Si la comprobación falla, el comando informa del error y termina con el código 1. Sin --online, el estado procede de lo guardado en su ordenador y no se contacta con nada. No tiene efecto en un perfil local.
devo info
Muestra información sobre una instancia de Devolutions Cloud o de Devolutions Server, para un contexto guardado o para una dirección, sin iniciar sesión.
Espacio de trabajo: Devolutions Cloud, Devolutions Server
<name>
Espacio de trabajo seleccionado
Contexto que consultar. Sin él y sin una dirección, se usa el espacio de trabajo seleccionado. Un perfil local se rechaza: el comando funciona solo con Devolutions Cloud y Devolutions Server. No se puede combinar con --cloud o --server. Con un contexto guardado y sin --private, solo se devuelve información pública y no se usa el inicio de sesión del contexto.
--cloud <url>
Dirección de Devolutions Cloud que consultar sin un contexto guardado. Las mismas reglas de dirección que devo login. No se puede combinar con --server ni con un nombre de contexto.
--server <url>
Dirección de Devolutions Server que consultar sin un contexto guardado. Solo se devuelve información pública. No se puede combinar con --cloud ni con un nombre de contexto.
--private
Desactivado
Solo Devolutions Server: añade información privada, usando el inicio de sesión de un contexto guardado. Se rechaza con --server <url>, y se rechaza para Devolutions Cloud.
devo context list
Enumera sus contextos de cada tipo de espacio de trabajo, ordenados por nombre, y muestra cuál es el actual. Alias: devo context ls.
Espacio de trabajo: Todos los tipos de espacio de trabajo
Este comando no tiene argumentos ni opciones propios.
devo context use
Convierte un contexto en el actual. Cada comando posterior lo usa, hasta que usted elija otro o lo sustituya para un comando con la opción global --context <name>.
Espacio de trabajo: Todos los tipos de espacio de trabajo
<name>
Contexto que convertir en actual. Obligatorio. Si el mismo nombre existe para más de un tipo de contexto, el comando se detiene y le dice que elimine uno de ellos con devo context delete <name> --kind <kind>.
devo context inspect
Muestra los detalles de un contexto: su tipo, su dirección o su carpeta de perfil y, para un perfil local, su espacio de trabajo predeterminado, su bóveda predeterminada y su descripción.
Espacio de trabajo: Todos los tipos de espacio de trabajo
<name>
Contexto actual
Contexto que mostrar. Sin él, se muestra el contexto actual; si ningún contexto es el actual, el comando se detiene y pide un nombre.
devo context delete
Quita un contexto. Alias: devo context rm. Si era el contexto actual, después ningún contexto es el actual.
Espacio de trabajo: Todos los tipos de espacio de trabajo
<name>
Contexto que eliminar. Obligatorio. Eliminar un contexto de perfil local quita solo el contexto: la carpeta de perfil no se toca.
--kind <kind>
Tipo de contexto que eliminar, cuando el mismo nombre existe para más de un tipo: sqlite (perfil local), cloud o server. Cualquier otro valor se rechaza.
--yes (-y, --confirmed)
Desactivado
Confirma la eliminación de un contexto de Devolutions Cloud o de Devolutions Server, lo que también descarta su inicio de sesión almacenado. Sin ella, ese contexto no se elimina. No hace falta para un contexto de perfil local.
Siguiente
Última actualización
¿Te fue útil?