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.
# 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.
------