Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administrar sesiones de Amazon DCV
Una vez configurados los servidores Amazon DCV e instaladas todas las aplicaciones, los clientes acceden a ellas mediante una sesión segura. La administración de estas sesiones para su cliente le otorga acceso y establece los parámetros para cada sesión.
Antes de que sus clientes puedan conectarse a una sesión de Amazon DCV, debe crearla en su servidor Amazon DCV. Los clientes solo pueden conectarse a un servidor Amazon DCV si hay una sesión activa.
Cada sesión de Amazon DCV tiene los atributos siguientes:
+ **ID de sesión**: se utiliza para identificar una sesión específica en el servidor Amazon DCV.
+ **Propietario**: el usuario de Amazon DCV que ha creado la sesión. De forma predeterminada, solo un propietario puede conectarse a la sesión.
Los clientes de Amazon DCV necesitan esta información para conectarse a la sesión.
**Topics**
+ [
# Descripción de las sesiones de Amazon DCV
](managing-sessions-intro.md)
+ [
# Uso de la herramienta de línea de comandos para administrar sesiones
](managing-sessions-cli.md)
+ [
# Inicio de sesiones de Amazon DCV
](managing-sessions-start.md)
+ [
# Detención de sesiones de Amazon DCV
](managing-sessions-lifecycle-stop.md)
+ [
# Visualización de sesiones de Amazon DCV
](managing-sessions-lifecycle-view.md)
+ [
# Administración de sesiones de Amazon DCV
](managing-running-session.md)
+ [
# Configuración de la zona horaria de la sesión
](managing-session-time-zone.md)
+ [
# Administración del bloqueo de pantalla en Linux
](managing-screen-blanking.md)
+ [
# Realización de una captura de pantalla en una sesión de Amazon DCV
](managing-sessions-lifecycle-screenshot.md)
# Descripción de las sesiones de Amazon DCV
Amazon DCV ofrece dos tipos de sesiones: sesiones de consola y sesiones virtuales. En la tabla siguiente se resumen las diferencias entre los dos tipos de sesiones.
| Tipo de sesión | Soporte | Varias sesiones | Permisos necesarios | Captura de pantalla directa | Compatibilidad con OpenGL acelerado por GPU |
| --- | --- | --- | --- | --- | --- |
| Consola | Servidores Amazon DCV para Linux, macOS y Windows | No, solo se permite una sesión de consola en cada servidor | Solo el usuario administrador puede iniciar y cerrar sesiones | Sí | Sí, sin software adicional |
| Virtual | Servidores Amazon DCV solo para Linux | Sí, se permiten varias sesiones virtuales en un único servidor | Cualquier usuario puede iniciar y cerrar sesiones | No, se ejecuta un servidor X dedicado (Xdcv) para cada sesión virtual. La pantalla se captura desde el servidor X. | Sí, pero requiere el paquete DCV-GL |
**nota**
No puede ejecutar sesiones de la consola y virtuales en el mismo servidor Amazon DCV al mismo tiempo.
## Sesiones de la consola
Las sesiones de consola son compatibles con los servidores Amazon DCV de Windows, Linux y macOS. Si utilizas un servidor Amazon DCV para Windows o macOS, solo puedes usar sesiones de consola.
Solo se puede hospedar una sesión de consola en el servidor Amazon DCV cada vez. Las sesiones de consola las crea y administra el administrador en los servidores Amazon DCV de Windows y el usuario raíz en los servidores Amazon DCV de Linux y macOS.
Con las sesiones de consola, Amazon DCV captura directamente el contenido de la pantalla del escritorio. Si el servidor está configurado con una GPU, las sesiones de consola de Amazon DCV tienen acceso directo a la GPU.
## Sesiones virtuales
Las sesiones virtuales solo se admiten en servidores Amazon DCV de Linux.
No puede ejecutar sesiones de consola y virtuales en el mismo servidor Amazon DCV al mismo tiempo. Los usuarios de Amazon DCV crean y administran sesiones virtuales. Los usuarios de Amazon DCV solo pueden administrar las sesiones que han creado. El usuario raíz puede administrar todas las sesiones virtuales que se ejecutan actualmente en el servidor Amazon DCV.
Con las sesiones virtuales, Amazon DCV inicia una instancia de servidor X, `Xdcv`, y ejecuta un entorno de escritorio dentro del servidor X. Amazon DCV inicia una nueva instancia de servidor X dedicada para cada sesión virtual. Cada sesión virtual utiliza la pantalla proporcionada por su instancia de servidor X.
**nota**
Si bien Amazon DCV garantiza que cada sesión virtual tenga una pantalla `Xdcv` independiente, muchos otros recursos del sistema, incluidos los archivos de la carpeta principal del usuario, los servicios D-Bus y los dispositivos, son para cada usuario y, por tanto, se compartirán y se podrá acceder a ellos en varias sesiones virtuales para el mismo usuario.
No debe ejecutar varias sesiones virtuales en el mismo servidor Amazon DCV para el mismo usuario al mismo tiempo, a menos que haya configurado el sistema operativo para mitigar posibles problemas relacionados con los recursos compartidos.
Si el `dcv-gl` paquete está instalado y tiene licencia, las sesiones virtuales de Amazon DCV comparten el acceso al servidor. GPUs Para compartir OpenGL basado en hardware en varias sesiones virtuales, debe conectar la instancia del servidor X virtual a la GPU. Para ello, debe configurar el archivo `dcv-gl.conf`.
# Uso de la herramienta de línea de comandos para administrar sesiones
El servidor Amazon DCV incluye una herramienta de la línea de comandos que sirve para iniciar, detener y ver sesiones de Amazon DCV.
## Uso de la herramienta de la línea de comandos en un servidor Amazon DCV de Windows
Para utilizar la herramienta de línea de comandos en un servidor Amazon DCV de Windows, debe ejecutar los comandos desde el directorio de instalación de Amazon DCV o agregar el directorio de Amazon DCV a la variable de entorno PATH. Si agrega el directorio Amazon DCV a la variable de entorno PATH, puede utilizar los comandos de cualquier directorio.
**Para utilizar la herramienta de línea de comandos desde el directorio de instalación de Amazon DCV**
Desplácese a la carpeta en la que se encuentra el archivo `dcv.exe`, `C:\Program Files\NICE\DCV\Server\bin\` de manera predeterminada, y abra una ventana del símbolo del sistema.
O bien, puede especificar la ruta completa al ejecutar un comando desde un directorio diferente.
```
"C:\> Program Files\NICE\DCV\Server\bin\dcv.exe" list-sessions
```
**Para agregar el directorio de Amazon DCV a la variable de entorno PATH**
1. En el Explorador de archivos, haga clic con el botón secundario en **This PC (Este ordenador)** y elija **Properties (Propiedades)**.
1. Elija **Advanced system settings (Configuración avanzada del sistema)**.
1. En la pestaña **Opciones avanzadas**, elija **Variables de entorno**.
1. En la sección **System variables (Variables de sistema)** seleccione la variable **Path (Ruta)** y elija **Edit (Editar)**.
1. Elija **Nuevo** y especifique la ruta completa de la carpeta `bin` en el directorio de instalación de Amazon DCV (por ejemplo, `C:\Program Files\NICE\DCV\Server\bin\`).
1. Elija **OK (Aceptar)** y cierre la ventana Environment Variables (Variables de entorno).
## Uso de la herramienta de la línea de comandos en un servidor Amazon DCV de Linux
En los servidores Amazon DCV de Linux, la herramienta de línea de comandos se configura automáticamente en la variable de entorno `$PATH`. Puede utilizar la herramienta desde cualquier carpeta. Abra una ventana de terminal e introduzca el comando que desea ejecutar.
## Uso de la línea de comandos en un servidor Amazon DCV para macOS
En los servidores Amazon DCV de macOS, la herramienta de línea de comandos se configura automáticamente en la variable de `$PATH` entorno. Puede utilizar la herramienta desde cualquier carpeta. Abra una ventana de terminal e introduzca el comando que desea ejecutar.
## Uso de la herramienta de línea de comandos
En la siguiente tabla se muestran las opciones de línea de comandos disponibles. Esta lista se puede recuperar utilizando `--help` al llamar a `dcv`. Para obtener más información sobre cómo usar cada comando, ingrese `--help` después del comando para el que desee obtener información sobre su uso. Por ejemplo: `dcv create-session --help`.
| Comando | Description (Descripción) |
| --- | --- |
| `create-session` | Crear una sesión de DCV nueva |
| `close-session` | Cerrar una sesión de DCV activa |
| `describe-session` | Describir una sesión de DCV |
| `list-sessions` | Enumerar las sesiones de DCV activas |
| `list-connections` | Enumerar las conexiones de cliente de una sesión de DCV |
| `close-connection` | Cerrar una conexión de cliente activa |
| `get-screenshot` | Hacer una captura de pantalla de la consola de DCV |
| `set-display-layout` | Configurar el diseño de visualización de una sesión de DCV activa |
| `set-name` | Definir el nombre de una sesión de DCV |
| `set-permissions` | Establecer los permisos de una sesión de DCV activa |
| `set-storage-root` | Establecer la raíz de almacenamiento de una sesión de DCV activa |
| `reload-licenses` | Obligar a recargar las licencias para todas las sesiones en ejecución |
| `get-config` | Obtener la configuración del servidor |
| `list-endpoints` | Enumerar los puntos de conexión de DCV |
| `set-config` | Establecer la configuración del servidor |
| `version` | Mostrar la versión de DCV |
| `help` | Mostrar la ayuda |
# Inicio de sesiones de Amazon DCV
Cuando utiliza la configuración predeterminada para [instalar el servidor Amazon DCV de Windows](setting-up-installing-wininstall.md), se crea y activa automáticamente una [sesión de consola](managing-sessions-intro.md#managing-sessions-intro-console) después de instalar el servidor. La sesión de la consola predeterminada es propiedad de `Administrator` y tiene un ID de sesión predeterminado de `console`. Puede utilizar esta sesión o [cerrarla](managing-sessions-lifecycle-stop.md) y crear una nueva.
Si ha optado por evitar la creación automática de sesiones de consola al instalar el servidor Amazon DCV, debe crear una manualmente. Después de instalar el servidor Amazon DCV, puede habilitar o deshabilitar la [creación automática de consolas](#managing-sessions-start-auto) en cualquier momento.
**nota**
Los servidores Amazon DCV para Linux y macOS no obtienen una sesión de consola predeterminada tras la instalación.
Supongamos que utiliza una licencia flotante en un servidor en las instalaciones o alternativo basado en la nube y supera el número máximo de sesiones simultáneas que admite su licencia. Es posible que se produzca un error `no licenses`. Si obtiene este error, detenga una sesión sin utilizar para liberar la licencia e inténtelo de nuevo.
El servidor Amazon DCV debe estar en ejecución para iniciar una sesión. Para obtener más información, consulte [Inicio del servidor Amazon DCV](manage-start.md).
**Topics**
+ [
## Inicio manual de sesiones de consola y virtuales
](#managing-sessions-start-manual)
+ [
## Habilitación de sesiones de la consola automáticas
](#managing-sessions-start-auto)
## Inicio manual de sesiones de consola y virtuales
Puede iniciar una sesión de Amazon DCV en cualquier momento. Solo puede ejecutar una sesión de la consola cada vez. Si utiliza un servidor Amazon DCV de Linux, puede ejecutar varias sesiones virtuales al mismo tiempo.
Se recomienda ejecutar `dcv list-sessions` antes de crear una sesión, especialmente si utiliza un servidor Amazon DCV de Windows.
Para crear una consola o sesión virtual en un servidor Amazon DCV Windows, Linux o macOS, utilice el `dcv create-session` comando.
**Topics**
+ [
### Sintaxis
](#managing-sessions-start-manual-syntax)
+ [
### Opciones
](#managing-sessions-start-manual-options)
+ [
### Ejemplos
](#managing-sessions-start-manual-examples)
### Sintaxis
La sintaxis mínima del comando para iniciar una sesión es:
```
dcv create-session session_ID
```
La sintaxis completa con todas las opciones es:
```
dcv create-session \
--type console|virtual \
--name session_name \
--user username \
--owner owner_name \
--permissions-file /path_to/permissions_file \
--storage-root /path_to/storage_directory \
--gl on|off \
--max-concurrent-clients number_of_clients \
--init /path_to/init_script \
session_ID
```
**nota**
El símbolo `\` representa la sintaxis para dividir un comando en varias líneas.
También se puede utilizar `dcv create-session --help` para mostrar una referencia rápida a la sintaxis.
### Opciones
Las siguientes opciones pueden utilizarse con el comando `dcv create-session`:
**`--type`**
Esta opción solo es compatible con servidores Amazon DCV de Linux. Especifica el tipo de sesión que se va a crear y puede ser `console` o `virtual`.
Tipo: cadena
Valores permitidos: `console` \$1 `virtual`
Obligatorio: no
**`--name`**
Especifica un nombre para la sesión. Los nombres puede ser cualquier cadena que desee con hasta 256 caracteres. Si la cadena supera 256 caracteres, se produce un error en el comando. No es necesario que los nombres de sesión sean únicos en todas las sesiones en ejecución.
Puede cambiar el nombre de una sesión en cualquier momento mediante el comando `dcv set-name`. Para obtener más información, consulte [Administrar el nombre de sesión](managing-session-name.md).
Tipo: cadena
Obligatorio: sí
**`--user`**
Esta opción solo es compatible con las sesiones virtuales en las sesiones de Amazon DCV de Linux. Este valor es el usuario que se va a utilizar para crear la sesión. Solo el usuario raíz puede suplantar a otros usuarios.
Tipo: cadena
Requerido: no
**`--owner`**
Especifica el propietario de la sesión. El valor predeterminado es el usuario que ha iniciado sesión actualmente si se omite.
Tipo: cadena
Requerido: no
**`--permissions-file`**
Especifica una ruta a un archivo de permisos personalizado. El valor predeterminado son los valores predeterminados del servidor si se omite.
Tipo: cadena
Requerido: no
**`--storage-root`**
Especifica la ruta a la carpeta usada para el almacenamiento de sesión.
Puede utilizar `%home%` para especificar el directorio principal del usuario que ha iniciado sesión actualmente. Por ejemplo, lo siguiente establece el directorio para el almacenamiento de sesiones como `c:\Users\username\storage\` para los servidores Windows o `$HOME/storage/` para los servidores Linux.
```
--storage-root %home%/storage/
```
Si no existe un subdirectorio especificado, se deshabilita el almacenamiento de sesiones.
Tipo: cadena
Requerido: no
**`--gl`**
Esta opción solo es compatible con las sesiones virtuales en las sesiones de Amazon DCV de Linux. Anula el estado `dcv-gl` predeterminado y puede ser `on` u `off`.
Tipo: cadena
Valores permitidos: `on` \$1 `off`
Obligatorio: no
**`--max-concurrent-clients`**
Especifica el número máximo de clientes Amazon DCV que tienen permiso para conectarse a la sesión. El valor predeterminado son las conexiones ilimitadas si se omite.
Tipo: entero
Obligatorio: no
**`--init`**
Esta opción solo es compatible con las sesiones virtuales en los servidores Amazon DCV de Linux. Especifica la ruta a un script `init` personalizado. El script se puede utilizar para iniciar un entorno de escritorio específico y lanzar aplicaciones específicas de forma automática al iniciarse la sesión. El script debe ser ejecutable. El valor predeterminado es un script que inicia el entorno de escritorio predeterminado si se omite.
Tipo: cadena
Requerido: no
**`session ID`**
Proporciona un identificador para la sesión al final del comando.
Tipo: cadena
Obligatorio: sí
### Ejemplos
**Ejemplo 1: Sesión de consola**
El comando siguiente crea una sesión de consola propiedad de `dcv-user` con el ID de sesión único de `my-session` y un nombre de sesión de `my graphics session`. Especifica un archivo de permisos llamado `perm-file.txt`.
+ Servidor Amazon DCV de Windows
```
C:\> dcv create-session^
--owner dcv-user^
--name "my graphics session"^
--permissions-file perm-file.txt^
my-session
```
+ Servidor Amazon DCV de Linux
```
$ sudo dcv create-session \
--type=console \
--owner dcv-user \
--name "my graphics session" \
--permissions-file perm-file.txt \
my-session
```
**Ejemplo 2: Sesión virtual (solo servidores Amazon DCV de Linux)**
El comando siguiente crea una sesión virtual utilizando el usuario raíz para suplantar al propietario de la sesión correspondiente, `dcv-user`. La sesión es propiedad de `dcv-user` aunque la haya creado el usuario raíz
```
$ sudo dcv create-session \
--owner dcv-user \
--user dcv-user \
my-session
```
**Ejemplo 3: Sesión virtual (solo servidores Amazon DCV de Linux)**
El comando siguiente crea una sesión virtual propiedad del usuario que la crea:
```
$ dcv create-session my-session
```
## Habilitación de sesiones de la consola automáticas
Al habilitar una sesión de consola automática se garantiza la creación automática de una sesión de la consola cada vez que se inicia el servidor Amazon DCV. La sesión de la consola automática es propiedad del usuario de Amazon DCV especificado por el parámetro de configuración `owner`. Su ID de sesión siempre es `console`.
Otros parámetros que afectan a las sesiones de consola automáticas son `max-concurrent-clients`, `permissions-file` y `storage-root`. Para obtener más información sobre estos parámetros, consulte [Parámetros de `session-management/automatic-console-session`](config-param-ref.md#session_management_automatic_console_session).
**nota**
Amazon DCV no admite las sesiones virtuales automáticas.
------
#### [ Windows Amazon DCV server ]
**Para habilitar una sesión de consola automática en un servidor Amazon DCV de Windows**
1. Abra el Editor del Registro de Windows.
1. Navegue hasta la **clave HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 dcvGSettings\$1 session-management**.
1. Cree un parámetro `create-session`:
1. En el panel de navegación, abra el menú contextual (clic con el botón derecho) para la clave **session-management** y elija **Nuevo**, **Valor DWORD (32 bits)**.
1. En **Name (Nombre)**, escriba `create-session` y pulse **Intro**.
1. Abra el parámetro **create-session**. En **Información del valor**, escriba `1` y elija **OK (Aceptar)**.
1. Navegue hasta la **clave HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 dcv\$1 session-management/**. GSettings automatic-console-session
1. Cree un parámetro `owner`:
1. ****En el panel de navegación, abra el menú contextual (haga clic con el botón derecho) de la clave y seleccione Nuevo, valor de cadena. **automatic-console-session******
1. En **Name (Nombre)**, escriba `owner` y pulse **Intro**.
1. Abra el parámetro **owner**. En **Información del valor**, escriba el nombre del propietario de la sesión y elija **OK (Aceptar)**.
1. Haga clic en **Aceptar** y cierre el Editor del Registro de Windows.
1. [Detenga](manage-stop.md) y [reinicie](manage-start.md) el servidor Amazon DCV.
------
#### [ Linux Amazon DCV server ]
**Para habilitar una sesión de consola automática en un servidor Amazon DCV de Linux**
1. Vaya a `/etc/dcv/` y abra `dcv.conf` con su editor de texto preferido.
1. Agregue los parámetros `create-session` y `owner` a la sección `[session-management/automatic-console-session]` con el siguiente formato:
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. Guarde y cierre el archivo.
1. [Detenga](manage-stop.md) y [reinicie](manage-start.md) el servidor Amazon DCV.
------
#### [ macOS Amazon DCV server ]
**Para habilitar una sesión de consola automática en un servidor Amazon DCV macOS**
1. Vaya a `/etc/dcv/` y abra `dcv.conf` con su editor de texto preferido.
1. Agregue los parámetros `create-session` y `owner` a la sección `[session-management/automatic-console-session]` con el siguiente formato:
```
[session-management]
create-session = true
[session-management/automatic-console-session]
owner="session-owner"
```
1. Guarde y cierre el archivo.
1. [Detenga](manage-stop.md) y [reinicie](manage-start.md) el servidor Amazon DCV.
------
# Detención de sesiones de Amazon DCV
Solo el administrador puede detener una sesión de consola en los servidores Amazon DCV de Windows y el usuario raíz en los servidores Amazon DCV de Linux y macOS. Las sesiones virtuales de un servidor Amazon DCV de Linux solo puede detenerlas el usuario raíz o el usuario de Amazon DCV que las creó.
**nota**
Al detener una sesión, se cierran todas las aplicaciones que se ejecutan en la sesión.
Para detener una sesión virtual o de consola en un servidor Amazon DCV Windows, Linux o macOS, utilice el `dcv close-session` comando y especifique el identificador de sesión único.
**Topics**
+ [
## Sintaxis
](#managing-sessions-lifecycle-stop-syntax)
+ [
## Ejemplo
](#example)
## Sintaxis
```
dcv close-session session-id
```
## Ejemplo
Por ejemplo, el siguiente comando detiene una sesión con el ID exclusivo de `my-session`.
```
dcv close-session my-session
```
# Visualización de sesiones de Amazon DCV
El administrador de un servidor Amazon DCV de Windows o el usuario raíz de un servidor Amazon DCV de Linux pueden ver todas las sesiones que se ejecutan en el servidor. Los usuarios de Amazon DCV solo pueden ver las sesiones que han creado.
**Topics**
+ [
## Visualización de todas las sesiones activas
](#list-all)
+ [
## Visualización de una sesión activa específica
](#view-specific)
## Visualización de todas las sesiones activas
Para mostrar las sesiones de consola o virtuales activas en un servidor Amazon DCV de Windows o Linux, utilice el comando `dcv list-sessions`.
**Topics**
+ [
### Sintaxis
](#list-all-syntax)
+ [
### Output
](#output)
### Sintaxis
```
dcv list-sessions
```
### Output
El comando devuelve una lista de sesiones activas con el siguiente formato:
```
Session: session-id (owner:session-owner type:virtual|console name:'my session')
```
## Visualización de una sesión activa específica
Para ver información sobre una sesión, utilice el comando `dcv describe-session` y especifique el ID de sesión único.
**Topics**
+ [
### Sintaxis
](#view-specific-syntax)
+ [
### Output
](#output)
### Sintaxis
```
$ dcv describe-session session_id
```
### Output
En el siguiente ejemplo de salida, el elemento `display-layout` indica que el diseño de pantalla de la sesión está configurado para utilizar dos pantallas de 800x600. De estas, la segunda pantalla está desplazada a x=800 (a la derecha) de la primera pantalla.
```
Session: test
owner: session-id
name: session-name
x display: :1
x authority: /run/user/1009/dcv/test.xauth
display layout: 800x600+0+0,800x600+800+0
```
También puede incluir la opción `--json` (o `-j`) para obligar al comando a devolver la salida en formato JSON. La salida JSON proporciona detalles adicionales sobre la sesión.
```
$ dcv describe-session session-id --json
```
A continuación se muestra la salida de ejemplo JSON.
```
{
"id" : "session-id",
"owner" : "dcvuser",
"name" : "session-name",
"num-of-connections" : 0,
"creation-time" : "2020-03-02T16:08:50Z",
"last-disconnection-time" : "",
"licenses" : [
{
"product" : "dcv",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "licensed",
"check-timestamp" : "2020-03-02T16:08:50Z",
"expiration-date" : "2020-03-29T00:00:00Z"
}
],
"storage-root" : "",
"type" : "virtual",
"x11-display" : ":2",
"x11-authority" : "/run/user/1009/dcv/vsession.xauth",
"display-layout" : [
{
"width" : 800,
"height" : 600,
"x" : 0,
"y" : 0
},
{
"width" : 800,
"height" : 600,
"x" : 800,
"y" : 0
}
]
}
```
# Administración de sesiones de Amazon DCV
Una vez que un cliente ha iniciado sesión y comienza a utilizar una sesión de DCV, la sesión se considera activa. Mientras la sesión esté activa, puede seguir realizando determinadas tareas de administración. En esta sección se proporciona la información que necesita para administrar los parámetros de estas sesiones mientras el cliente las sigue utilizando.
**Topics**
+ [Administrar el almacenamiento de sesiones](managing-session-storage.md)
+ [Administrar la autorización de sesión](managing-session-perms.md)
+ [Administrar el diseño de pantalla de la sesión](managing-session-display.md)
+ [
# Administrar el nombre de sesión
](managing-session-name.md)
+ [
# Búsqueda y detención de sesiones inactivas
](stop-idle-sessions.md)
# Administración del almacenamiento de sesiones de Amazon DCV
El almacenamiento de sesiones es un directorio del servidor Amazon DCV al que pueden tener acceso los clientes al conectarse a una sesión de Amazon DCV.
Si el almacenamiento de sesiones se ha habilitado en el servidor Amazon DCV, puede utilizar el comando `dcv set-storage-root` para especificar el directorio que se utilizará para el almacenamiento de sesiones. Para obtener más información acerca de cómo habilitar el almacenamiento de sesiones en el servidor Amazon DCV, consulte [Habilitar almacenamiento de sesiones](manage-storage.md).
Para establecer la ruta del almacenamiento de sesiones, utilice el comando `dcv set-storage-root` y especifique el ID de sesión y la ruta del directorio que se van a utilizar.
**Topics**
+ [
## Sintaxis
](#managing-session-storage-syntax)
+ [
## Opciones
](#managing-session-storage-options)
+ [
## Ejemplos
](#session-storage-example)
## Sintaxis
```
dcv set-storage-root --session session_id /path_to/directory
```
Como ruta del directorio puede utilizar `%home%` para especificar el directorio principal del usuario que ha iniciado la sesión actual. Por ejemplo, la ruta de acceso `%home%/storage/` se resuelve en `c:\Users\username\storage\` en servidores Windows. Se resuelve en `$HOME/storage/` en servidores Linux.
**nota**
El `storage-root` valor debe ser una ruta absoluta en macOS.
## Opciones
Puede utilizar las siguientes opciones con el comando `dcv set-storage-root`.
**`--session`**
ID de sesión para el que se debe especificar el directorio de almacenamiento.
Tipo: cadena
Obligatorio: sí
## Ejemplos
**Ejemplo de servidor Amazon DCV de Windows**
En el ejemplo siguiente se establece la ruta de almacenamiento en `c:\session-storage` para una sesión con un identificador de sesión de `my-session`.
```
C:\> dcv set-storage-root --session my-session c:\session-storage
```
**Ejemplo de servidor Amazon DCV de Linux**
En el ejemplo siguiente se establece la ruta de almacenamiento de un directorio denominado `session-storage` en el directorio principal del usuario actual, para una sesión con un identificador de sesión de `my-session`.
```
$ dcv set-storage-root --session my-session %home%/session-storage/
```
# Administración de la autorización de sesión de Amazon DCV
La autorización se utiliza para conceder o denegar permisos de clientes Amazon DCV a características de Amazon DCV concretas. La autorización suele configurarse cuando se inicia una sesión de Amazon DCV. Sin embargo, es posible editar los permisos de una sesión en ejecución. Para obtener más información acerca de la autorización de Amazon DCV, consulte [Configuración de la autorización de Amazon DCV](security-authorization.md).
Para modificar los permisos de una sesión en ejecución, utilice el comando `dcv set-permissions`.
**Topics**
+ [
## Sintaxis
](#managing-session-perms-syntax)
+ [
## Opciones
](#managing-session-perms-options)
+ [
## Ejemplos
](#session-perms-example)
## Sintaxis
```
dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file
```
Debe especificar `--none`, `--reset-builtin` o `--file`.
## Opciones
Las siguientes opciones pueden utilizarse con el comando `dcv set-permissions`.
**--session**
Especifica el ID de la sesión para la que se deben establecer los permisos.
**--reset-builtin**
Restablece los permisos de la sesión a los permisos de sesión predeterminados. Los permisos predeterminados otorgan acceso completo a todas las características solo al propietario de la sesión.
**--none**
Revoca todos los permisos de la sesión.
**--file**
Especifica la ruta de un archivo de permisos personalizado. Si el archivo especificado está vacío, se revocarán todos los permisos. Para obtener más información acerca de cómo crear un archivo de permisos personalizado, consulte [Descripción de archivos de permiso](security-authorization-file-create.md).
## Ejemplos
**Ejemplo 1: Revocar todos los permisos**
En el ejemplo siguiente se revocan todos los permisos del cliente para una sesión con un identificador de `my-session`.
```
C:\> dcv set-permissions --session my-session --none
```
**Ejemplo 2: Especificar permisos personalizados**
En el ejemplo siguiente se especifica un archivo de permisos personalizado llamado `perm-file.txt` para una sesión con el ID de `my-session`. Este archivo se encuentra en el directorio `c:\dcv\`.
```
C:\> dcv set-permissions --session my-session --file c:\dcv\perm-file.txt
```
**Ejemplo 3: Restablecer los permisos**
El siguiente ejemplo restablece los permisos a los predeterminados de una sesión con ID `my-session`.
```
C:\> dcv set-permissions --session my-session --reset-builtin
```
# Administración del diseño de pantalla de la sesión de Amazon DCV
Puede establecer el diseño de pantalla de una sesión de Amazon DCV en ejecución. El diseño de pantalla especifica la configuración predeterminada que se utiliza cuando los clientes se conectan a la sesión. Sin embargo, los clientes pueden anular manualmente el diseño mediante la configuración del cliente Amazon DCV o la configuración de visualización del sistema operativo nativo.
Si la configuración de hardware y software del servidor host no admite la resolución especificada o el número de pantallas, el servidor Amazon DCV no aplica el diseño de pantalla especificado.
Amazon DCV puede configurar una resolución de acuerdo con los ajustes y la configuración del sistema del servidor.
+ La resolución del cliente web está limitada de forma predeterminada a 1920 x 1080 (según la configuración del servidor web-client-max-head con resolución R).
+ Los clientes nativos están limitados de forma predeterminada a 4096 x 2160 (desde). max-head-resolution
Tenga en cuenta que las resoluciones disponibles y la cantidad de monitores dependen de la configuración del servidor; asegúrese de seguir la [guía de requisitos previos](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing.html) para configurar correctamente el entorno del sistema y los controladores a fin de obtener el mejor rendimiento.
**nota**
Para los clientes nativos, se pueden utilizar hasta un máximo de cuatro monitores.
Para los clientes web, se pueden utilizar hasta un máximo de dos monitores.
No se admiten resoluciones más altas o más del número máximo de monitores en ninguna configuración.
**Topics**
+ [
## Acceso al diseño de pantalla
](#display-restrict)
+ [
## Configurar el diseño de pantalla
](#dislay-set)
+ [
## Ver el diseño de pantalla
](#dislay-view)
## Acceso al diseño de pantalla
Puede configurar el servidor Amazon DCV para evitar que los clientes soliciten diseños de pantalla que están fuera de un intervalo especificado. Para restringir los cambios en el diseño de pantalla, configure los siguientes parámetros del servidor Amazon DCV.
+ [`enable-client-resize`](config-param-ref.md#paramref.display.enable-client-resize): para evitar que los clientes cambien el diseño de la pantalla, defina este parámetro en `false`.
+ [`min-head-resolution`](config-param-ref.md#paramref.display.min-head-resolution) y [`max-head-resolution`](config-param-ref.md#paramref.display.max-head-resolution): especifican las resoluciones mínima y máxima permitidas, respectivamente.
+ [`web-client-max-head-resolution`](config-param-ref.md#paramref.display.web-client-max-head-resolution): especifica la resolución máxima permitida para clientes de navegador web. Se aplica la limitación `max-head-resolution` además de la limitación `web-client-max-head-resolution`. De forma predeterminada, la resolución máxima para los clientes de navegador web es de 1920 x 1080. Si se especifica una resolución más alta es posible que se produzcan problemas de rendimiento, según el navegador web y las especificaciones del ordenador cliente.
+ [`max-num-heads`](config-param-ref.md#paramref.display.max-num-heads): especifica el número máximo de pantallas.
+ `max-layout-area`: especifica el número máximo de píxeles permitido para el área de la pantalla. Se ignoran las solicitudes en las que el área total de la pantalla expresada en píxeles supere el valor especificado.
Para obtener más información acerca de estos parámetros, consulte [Parámetros de `display`](config-param-ref.md#display) en la referencia de parámetros.
## Configurar el diseño de pantalla
**Para configurar el diseño de pantalla de una sesión de Amazon DCV en ejecución**
Utilice el comando `dcv set-display-layout` y especifique la sesión para la que desea establecer el diseño de pantalla y el descriptor de diseño de pantalla.
```
dcv set-display-layout --session session-id display-layout-descriptor
```
El descriptor de diseño de pantalla especifica el número de visualizaciones y el desfase de resolución y posición de cada visualización. La descripción debe especificarse con el siguiente formato:
```
widthxheight+|-x-position-offset+|-y-position-offset
```
Si especifica más de una pantalla, separe los descriptores de pantalla con una coma. Los desplazamientos de posición de la pantalla especifican la posición de la esquina superior izquierda de la pantalla con respecto a la pantalla 1. Si no especifica un desplazamiento de posición para una pantalla, el valor predeterminado es x=0 e y=0.
**importante**
Si especifica más de una pantalla, asegúrese de establecer correctamente el desplazamiento de posición de cada pantalla para evitar solapamientos de pantalla.
Por ejemplo, el siguiente descriptor de diseño de pantalla especifica dos pantallas:
+ Pantalla 1: resolución 1920x1080 con desplazamiento en x=0, y=0
+ Pantalla 2: resolución 800x600 con desplazamiento en x=1920, y=0 para que aparezca a la derecha de la pantalla 1.
![\[Diseño de pantalla con dos pantallas.\]](http://docs.aws.amazon.com/es_es/dcv/latest/adminguide/images/eg2.png)
```
1920x1080+0+0,800x600+1920+0
```
El siguiente descriptor de diseño de pantalla especifica tres pantallas.
+ Pantalla 1: resolución 1920x1080 con desplazamiento en x=0, y=0
+ Pantalla 2: resolución 1920x1080 con desplazamiento en x=1920, y=0 para que aparezca a la derecha de la pantalla 1.
+ Pantalla 3: resolución 1024x768 con desplazamiento en x=-1024, y=0 para que aparezca a la izquierda de la pantalla 1.
![\[Diseño de pantalla con tres pantallas.\]](http://docs.aws.amazon.com/es_es/dcv/latest/adminguide/images/eg1.png)
```
1920x1080+0+0,1920x1080+1920+0,1024x768-1024+0
```
## Ver el diseño de pantalla
**Para ver el diseño de pantalla de una sesión**
Utilice el comando `dcv describe-session` y revise el elemento `display layout` en la salida. Para obtener más información, consulte [Visualización de sesiones de Amazon DCV](managing-sessions-lifecycle-view.md).
# Administrar el nombre de sesión
Puede cambiar el nombre de una sesión en ejecución en cualquier momento. Puede utilizar el nombre específico de la sesión para identificar rápidamente una sesión de acuerdo con su nombre. No es necesario que los nombres de sesión sean únicos en todas las sesiones en ejecución.
Para cambiar el nombre de una sesión en ejecución, utilice el comando `dcv set-name`.
**Topics**
+ [
## Sintaxis
](#managing-session-name-syntax)
+ [
## Opciones
](#managing-session-name-options)
+ [
## Ejemplos
](#example)
## Sintaxis
```
$ dcv set-name --session session_id --none |--name "session-name"
```
Debe especificar `--name` o `--none`.
## Opciones
Las siguientes opciones pueden utilizarse con el comando `dset-name`.
**`--session`**
ID de la sesión para el que se va a establecer el nombre.
Tipo: cadena
Obligatorio: sí
**`--name`**
Nombre que se va a asignar a la sesión. Especifique esta opción únicamente si desea asignar un nombre a la sesión. Si desea eliminar un nombre, omita este parámetro. El nombre de sesión puede tener una longitud de hasta 256 caracteres. La contraseña puede contener letras, números y caracteres especiales. Si la cadena supera 256 caracteres, se produce un error en el comando.
Tipo: cadena
Requerido: no
**`--none`**
Especifique este parámetro para eliminar un nombre existente de una sesión. Si no desea eliminar el nombre de la sesión, omita esta opción.
Obligatorio: no
## Ejemplos
**Ejemplo 1: Cambiar el nombre de una sesión**
El siguiente ejemplo establece el nombre de una sesión con un ID de `my-session` a `my graphics session`.
```
$ dcv set-name --session my-session --name "my graphics sessions"
```
**Ejemplo 2: Eliminar el nombre de una sesión**
El siguiente ejemplo elimina el nombre de una sesión con un ID de `my-session`.
```
$ dcv set-name --session my-session --none
```
# Búsqueda y detención de sesiones inactivas
Puede identificar las sesiones de Amazon DCV inactivas mediante el comando `dcv describe-sessions` de la CLI con la opción de comando `-j`. Al especificar la opción `-j`, se configura el comando para devolver la salida en formato JSON, que proporciona detalles adicionales sobre la sesión.
Por ejemplo, el siguiente comando devuelve información sobre una sesión denominada `my-session`.
```
$ dcv describe-session my-session -j
```
Salida:
```
{
"id" : "my-session",
"owner" : "dcvuser",
"x11-display" : ":1",
"x11-authority" : "/run/user/1009/dcv/test3.xauth",
"num-of-connections" : 1,
"creation-time" : "2019-05-13T13:21:19.262883Z",
"last-disconnection-time" : "2019-05-14T12:32:14.357567Z",
"licensing-mode" : "DEMO",
"licenses" : [
{
"product" : "dcv",
"status" : "LICENSED",
"check-timestamp" : "2019-05-14T12:35:40Z",
"expiration-date" : "2019-05-29T00:00:00Z"
},
{
"product" : "dcv-gl",
"status" : "LICENSED",
"check-timestamp" : "2019-05-14T12:35:40Z",
"expiration-date" : "2019-05-29T00:00:00Z"
}
]
}
```
En el resultado del comando, el parámetro `num-of-connections` indica el número de conexiones de cliente activas. Un valor de `0` indica que actualmente no hay conexiones de cliente activas y la sesión está inactiva. También puede utilizar el parámetro `last-disconnection-time` para determinar cuándo hubo la última conexión de cliente activa en la sesión.
Puede crear un script o trabajo cron que utilice esta información para identificar sesiones inactivas. A continuación, puede dejar de usarlos mediante el comando [`dcv close-session`](managing-sessions-lifecycle-stop.md).
**nota**
Al detener una sesión, se cierran todas las aplicaciones que se ejecutan en la sesión.
# Configuración de la zona horaria de la sesión
DCV permite a los propietarios y usuarios de sesiones establecer la zona horaria de su sesión para que refleje la ubicación del servidor DCV o su ubicación actual.
Si solo se requiere que los usuarios individuales de una sesión dispongan de esta característica, primero tendrá que configurar el parámetro centralizado para todos los usuarios y, a continuación, ajustar los permisos individuales por separado mediante la creación de un archivo de permisos personalizado en [Añadir permisos](security-authorization-file-create-permission.md).
**nota**
Esta característica no está disponible en sesiones virtuales de Linux.
**nota**
En macOS, la redirección de zona horaria se aplica después de iniciar sesión.
**Habilitar redireccionamiento de zona horaria**
Puede activar y desactivar esta característica para todos los usuarios de una sesión específica.
1. Modifique el parámetro [`enable-timezone-redirection`](config-param-ref.md#paramref.redirection.enable-timezone-redirection) a uno de los siguientes valores:
+ `always-on`: el redireccionamiento de zona horaria siempre está habilitado.
La característica se activará y la sesión mostrará la información de zona horaria del cliente. El usuario no podrá desactivar la característica.
+ `always-off`: el redireccionamiento de zona horaria siempre está desactivado.
La característica se desactivará y la sesión mostrará su propia información de zona horaria. El usuario no podrá activar la característica.
+ `client-decides`: el redireccionamiento de zona horaria está activado de forma predeterminada.
La sesión tendrá la característica habilitada, mostrará la zona horaria del cliente y el usuario tendrá la opción de deshabilitarla para que se muestre la zona horaria del servidor.
**nota**
Esta configuración es la predeterminada estándar.
1. Reinicie las sesiones afectadas para que aparezcan los cambios.
# Administración del bloqueo de pantalla en Linux
Para las sesiones de la consola en un servidor Linux, DCV deja en blanco la pantalla local de forma predeterminada cuando hay al menos un usuario remoto conectado al servidor y restaura la salida (también bloqueando la pantalla) al desconectar al último usuario remoto.
Esto impide que el usuario que se encuentra cerca físicamente de un servidor vea la pantalla e interactúe con la sesión remota mediante los dispositivos de entrada conectados al host. Esto puede no ser aconsejable por motivos de privacidad o por el cumplimiento de la legislación local cuando se trabaja de forma remota en sesiones de consola. La entrada local se impide mediante la desactivación de los dispositivos conectados físicamente, como el teclado y el ratón. Los dispositivos de entrada se desactivan en cuanto se conectan o cuando se descubre que están activados. Del mismo modo, los dispositivos de entrada se vuelven a activar cuando no hay ningún usuario remoto conectado, lo que permite el inicio de sesión y la interacción locales.
**Deshabilitar la pantalla en blanco y el bloqueo de entradas**
La pantalla en blanco se puede desactivar mediante el siguiente procedimiento:
1. Vaya a `/etc/dcv/` y abra el archivo `dcv.conf` con su editor de texto preferido.
1. Localice `disable-local-console parameter` en la sección `[display/linux]`. Para permitir que las pantallas conectadas localmente permanezcan activas y muestren la sesión remota en curso, y permitir la interacción a través del conjunto de dispositivos conectados localmente, establezca `disable-local-console=false`. El valor predeterminado es `true` (es decir, pantalla en blanco y bloqueo de entrada activo). Si no hay un parámetro `disable-local-console` en la sección `[display/linux]`, agréguelo manualmente con el siguiente formato:
```
[display/linux]
disable-local-console=false|true
```
1. Guarde y cierre el archivo.
1. [Detenga](manage-stop.md) y [reinicie](manage-start.md) el servidor Amazon DCV.
**Impedir que los dispositivos de entrada seleccionados se deshabiliten**
Se pueden configurar dispositivos específicos para que permanezcan activados.
Los dispositivos de entrada cuyo nombre comience por `DCV ` (preste atención al espacio que aparece después del nombre) nunca se desactivarán, independientemente del valor de la configuración de `display-local-console`. Para cambiar el nombre de los dispositivos de entrada, consulte esta guía: [Habilitar el lápiz óptico](enable-stylus.md).
# Realización de una captura de pantalla en una sesión de Amazon DCV
Puede utilizar el comando `dcv get-screenshot` para hacer una captura de pantalla del escritorio durante la sesión en ejecución.
## Sintaxis
```
dcv get-screenshot --max-width pixels --max-height pixels --format JPEG|PNG --primary --json --output /path_to/destination session_name
```
## Opciones
**`--max-width`**
Especifica el ancho máximo, en píxeles, de la captura de pantalla. Si no especifica la anchura o la altura, la captura de pantalla utilizará la resolución de pantalla de la sesión. Si solo especifica la altura, la anchura se ajusta automáticamente para mantener la relación de aspecto.
Tipo: entero
Obligatorio: no
**`--max-height`**
Especifica la anchura máxima, en píxeles, de la captura de pantalla. Si no especifica la anchura o la altura, la captura de pantalla utilizará la resolución de pantalla de la sesión. Si solo especifica la altura, la anchura se escala automáticamente para mantener la relación de aspecto.
Tipo: entero
Obligatorio: no
**`--format`**
Formato de archivo de la captura de pantalla. Actualmente, los formatos compatibles son `JPEG` y `PNG`. Si especifica tipos de archivo en conflicto para las opciones `--format` y `--output`, el valor especificado para `--format` tendrá prioridad. Por ejemplo, si especifica `--format JPEG` y `--output myfile.png`, Amazon DCV crea un archivo de imagen JPEG.
Tipo: cadena
Valores permitidos: `JPEG` \$1 `PNG`
Obligatorio: no
**`--primary`**
Indica si se debe realizar una captura de pantalla únicamente de la pantalla principal. Para obtener una captura de pantalla de la pantalla principal únicamente, especifique `--primary`. Para obtener una captura de pantalla de todas las pantallas, omita esta opción. Si opta por obtener una captura de pantalla de todas las pantallas, se combinarán en una sola captura de pantalla.
Obligatorio: no
**`--json`, `-j`**
Indica si se debe entregar la salida en formato JSON codificada en base64. Para obtener salida JSON, especifique `--json`. De lo contrario, omítalo.
Obligatorio: no
**`--output`, `-o`**
Especifica la ruta de destino, el nombre de archivo y el tipo de archivo de la captura de pantalla. Por ejemplo, para Windows, especifique `c:\directory\filename.format` y para Linux, `/directory/filename.format`. El formato debe ser `.png` o `.jpeg`. Si especifica tipos de archivo en conflicto para las opciones `--format` y `--output`, el valor especificado para `--format` tendrá prioridad. Por ejemplo, si especifica `--format JPEG` y `--output myfile.png`, Amazon DCV crea un archivo de imagen JPEG.
Tipo: cadena
Obligatorio: no
## Ejemplos
**Ejemplo 1**
El siguiente comando de ejemplo realiza una captura de pantalla de una sesión llamada `my-session`. La captura de pantalla utiliza la resolución del servidor.
```
dcv get-screenshot --output myscreenshot.png my-session
```
**Ejemplo 2**
El siguiente comando de ejemplo toma una captura de pantalla de `200` píxeles de ancho por `100` píxeles de alto. La toma de una sesión llamada `my-session`. Guarda la captura de pantalla en el directorio actual con el nombre del archivo `myscreenshot.png`.
```
dcv get-screenshot --max-width 200 --max-height 100 --output myscreenshot.png my-session
```
**Ejemplo 3**
El siguiente comando de ejemplo realiza una captura de pantalla de una sesión llamada `my-session`. La captura de pantalla es solo de la pantalla principal. Guarda el archivo en el directorio actual con el nombre de la captura de pantalla `myscreenshot.png`.
```
dcv get-screenshot --primary --output myscreenshot.jpeg my-session
```
**Ejemplo 4**
El siguiente comando de ejemplo toma una captura de pantalla de una sesión llamada `my-session`. El comando genera el archivo codificado en base64 y en formato JSON.
```
dcv get-screenshot --json --format png my-session
```