As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Iniciar sessões do Amazon DCV Quando você usa os padrões para [instalar o servidor Amazon DCV do Windows](setting-up-installing-wininstall.md), uma [sessão de console](managing-sessions-intro.md#managing-sessions-intro-console) é criada automaticamente e fica ativa após a instalação do servidor. A sessão padrão do console pertence ao `Administrator` e tem o ID da sessão padrão do `console`. Você pode usar essa sessão ou [fechá-la](managing-sessions-lifecycle-stop.md) e criar uma nova sessão. Se você optou por impedir a criação automática da sessão de console quando instalou o servidor Amazon DCV, precisará criar uma manualmente. Depois de instalar o servidor Amazon DCV, é possível habilitar ou desabilitar a [criação automática da sessão de console](#managing-sessions-start-auto) a qualquer momento. **nota** Os servidores Amazon DCV Linux e macOS não recebem uma sessão de console padrão após a instalação. Suponha que você esteja usando uma licença flutuante on-premises ou servidor em nuvem alternativo e exceda o número máximo de sessões simultâneas compatível com a licença. Você pode receber um erro `no licenses`. Se receber esse erro, encerre a sessão não utilizada para liberar a licença e tente novamente. O servidor Amazon DCV deve estar em execução para iniciar a sessão. Para obter mais informações, consulte [Como iniciar o servidor Amazon DCV](manage-start.md). **Topics** + [ ## Iniciar manualmente sessões virtuais e de console ](#managing-sessions-start-manual) + [ ## Habilitação de sessões automáticas do console ](#managing-sessions-start-auto) ## Iniciar manualmente sessões virtuais e de console Você pode iniciar uma sessão do Amazon DCV a qualquer momento. Você só pode executar uma sessão do console por vez. Se você estiver usando um servidor Amazon DCV do Linux, poderá executar várias sessões virtuais ao mesmo tempo. É uma boa prática executar `dcv list-sessions` antes de criar uma sessão, especialmente se você estiver usando o servidor Amazon DCV do Windows. Para criar um console ou uma sessão virtual em um servidor Amazon DCV Windows, Linux ou macOS, use o comando. `dcv create-session` **Topics** + [ ### Sintaxe ](#managing-sessions-start-manual-syntax) + [ ### Opções ](#managing-sessions-start-manual-options) + [ ### Exemplos ](#managing-sessions-start-manual-examples) ### Sintaxe A sintaxe mínima do comando para iniciar uma sessão é: ``` dcv create-session session_ID ``` A sintaxe completa com todas as opçõ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** O símbolo `\` representa a sintaxe para dividir um comando em várias linhas. Você também pode usar `dcv create-session --help` para exibir uma referência rápida à sintaxe. ### Opções As opções a seguir podem ser usadas com o comando `dcv create-session`: **`--type`** Esta opção é compatível apenas com servidores Amazon DCV do Linux. Ela especifica o tipo de sessão a ser criada e pode ser `console` ou `virtual`. Tipo: string Valores permitidos: `console` \$1 `virtual` Obrigatório: não **`--name`** Especifica um nome para a sessão. Os nomes das sessões podem ser qualquer string de até 256 caracteres. Se a string exceder 256 caracteres, o comando falhará. Os nomes das sessões não precisam ser exclusivos nas sessões em execução. Você pode alterar o nome de uma sessão a qualquer momento usando o comando `dcv set-name`. Para obter mais informações, consulte [Gerenciar o nome da sessão](managing-session-name.md). Tipo: String Obrigatório: Sim **`--user`** Essa opção é compatível com sessões virtuais somente em sessões da Amazon DCV do Linux. Esse valor é o usuário a ser usado para criar a sessão. Somente o usuário raiz pode representar outros usuários. Tipo: string Obrigatório: não **`--owner`** Especifica o proprietário da sessão. O padrão é o usuário conectado no momento, se omitido. Tipo: string Obrigatório: não **`--permissions-file`** Especifica um caminho para um arquivo de permissões personalizadas. O padrão é o servidor padrão, se omitido. Tipo: string Obrigatório: não **`--storage-root`** Especifica o caminho para a pasta a ser usada para armazenamento de sessão. É possível usar `%home%` para especificar o diretório inicial do usuário que está conectado no momento. Por exemplo, o seguinte define o diretório para armazenamento de sessão como `c:\Users\username\storage\` para servidores do Windows ou como `$HOME/storage/` para servidores do Linux. ``` --storage-root %home%/storage/ ``` Se um subdiretório especificado não existir, o armazenamento da sessão será desabilitado. Tipo: string Obrigatório: não **`--gl`** Essa opção é compatível com sessões virtuais somente em sessões da Amazon DCV do Linux. Ela substitui o estado padrão `dcv-gl` e pode ser `on` ou `off`. Tipo: string Valores permitidos: `on` \$1 `off` Obrigatório: não **`--max-concurrent-clients`** Especifica o número máximo de clientes Amazon DCV que têm permissão para se conectar à sessão. O padrão é um número ilimitado de conexões, se omitido. Tipo: inteiro Obrigatório: não **`--init`** Essa opção é compatível com sessões virtuais somente em servidores Amazon DCV do Linux. Ela especifica o caminho para um script `init` personalizado. O script pode ser usado para iniciar um ambiente de desktop específico e iniciar aplicativos específicos automaticamente quando a sessão é iniciada. O script deve ser executável. O padrão é um script que inicia o ambiente de desktop padrão, se omitido. Tipo: string Obrigatório: não **`session ID`** Fornece um ID para sua sessão no final do comando. Tipo: String Obrigatório: Sim ### Exemplos **Exemplo 1 - Sessão do console** O comando a seguir cria uma sessão de console pertencente a `dcv-user` com um ID exclusivo de sessão `my-session` e um nome de sessão `my graphics session`. Ele também especifica um arquivo de permissões chamado `perm-file.txt`. + Servidor Amazon DCV do Windows ``` C:\> dcv create-session^ --owner dcv-user^ --name "my graphics session"^ --permissions-file perm-file.txt^ my-session ``` + Servidor Amazon DCV do Linux ``` $ sudo dcv create-session \ --type=console \ --owner dcv-user \ --name "my graphics session" \ --permissions-file perm-file.txt \ my-session ``` **Exemplo 2: sessão virtual (somente servidores Amazon DCV do Linux)** O comando a seguir cria uma sessão virtual usando o usuário raiz para representar o proprietário da sessão pretendida, `dcv-user`. A sessão pertence a `dcv-user`, embora ela tenho sido criada pelo usuário raiz. ``` $ sudo dcv create-session \ --owner dcv-user \ --user dcv-user \ my-session ``` **Exemplo 3: sessão virtual (somente servidores Amazon DCV do Linux)** O comando a seguir cria uma sessão virtual que pertence ao usuário que a criou: ``` $ dcv create-session my-session ``` ## Habilitação de sessões automáticas do console Habilitar uma sessão de console automática garante que uma sessão de console seja criada automaticamente toda vez que o servidor Amazon DCV iniciar. A sessão de console automática pertence ao usuário do Amazon DCV especificado pelo parâmetro de configuração `owner`. Seu ID de sessão é sempre `console`. Outros parâmetros que afetam as sessões do console automática são `max-concurrent-clients`, `permissions-file` e `storage-root`. Para mais informações sobre esses parâmetros, consulte [Parâmetros do `session-management/automatic-console-session`](config-param-ref.md#session_management_automatic_console_session). **nota** O Amazon DCV não é compatível com sessões virtuais automáticas. ------ #### [ Windows Amazon DCV server ] **Para habilitar uma sessão automática do console em um servidor Amazon DCV do Windows** 1. Abrir o Editor do Registro do Windows. 1. Navegue até a **chave HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 GSettings dcv\$1** session-management. 1. Crie um parâmetro `create-session`: 1. No painel de navegação, abra o menu de contexto (clique com o botão direito do mouse) da chave **session-management** e escolha **Novo**, **Valor de DWORD (32 bits)**. 1. Em **Nome**, insira `create-session` e pressione **Enter**. 1. Abra o parâmetro **create-session**. Em **Dados de valor**, digite `1` e escolha **OK**. 1. Navegue até a **chave HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftware\$1 dcvGSettings\$1** session-management/. automatic-console-session 1. Crie um parâmetro `owner`: 1. No painel de navegação, abra o menu de contexto (clique com o botão direito do mouse) da **automatic-console-session**chave e escolha **Novo**, Valor da sequência de **caracteres**. 1. Em **Nome**, insira `owner` e pressione **Enter**. 1. Abra o parâmetro **owner**. Em **Valor de dados**, insira o nome do proprietário da sessão e escolha **OK**. 1. Escolha **OK** e feche o Editor do Registro do Windows. 1. [Interrompa](manage-stop.md) e [reinicie](manage-start.md) o servidor Amazon DCV. ------ #### [ Linux Amazon DCV server ] **Para habilitar uma sessão de console automática em um servidor Amazon DCV do Linux** 1. Navegue até `/etc/dcv/` e abra o `dcv.conf` com seu editor de texto escolhido. 1. Adicione os parâmetros `create-session` e `owner` à seção `[session-management/automatic-console-session]` usando o seguinte formato: ``` [session-management] create-session = true [session-management/automatic-console-session] owner="session-owner" ``` 1. Salve e feche o arquivo. 1. [Interrompa](manage-stop.md) e [reinicie](manage-start.md) o servidor Amazon DCV. ------ #### [ macOS Amazon DCV server ] **Para habilitar uma sessão de console automática em um servidor macOS Amazon DCV** 1. Navegue até `/etc/dcv/` e abra o `dcv.conf` com seu editor de texto escolhido. 1. Adicione os parâmetros `create-session` e `owner` à seção `[session-management/automatic-console-session]` usando o seguinte formato: ``` [session-management] create-session = true [session-management/automatic-console-session] owner="session-owner" ``` 1. Salve e feche o arquivo. 1. [Interrompa](manage-stop.md) e [reinicie](manage-start.md) o servidor Amazon DCV. ------