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á. # Gerenciar sessões do Amazon DCV Gerenciar sessões do Amazon DCV Depois que os servidores Amazon DCV estiverem configurados e todos os seus aplicativos instalados, os clientes os acessarão por meio de uma sessão segura. Gerenciar essas sessões para seu cliente concede a ele acesso e define os parâmetros para cada sessão. Antes que seus clientes possam se conectar, você deve criar uma sessão do Amazon DCV em seu servidor Amazon DCV. Os clientes só podem se conectar a um servidor Amazon DCV se houver uma sessão ativa. Cada sessão do Amazon DCV tem os atributos a seguir: + **ID da sessão**: usado para identificar uma sessão específica no servidor Amazon DCV. + **Proprietário**: o usuário do Amazon DCV que criou a sessão. Por padrão, apenas um proprietário pode se conectar à sessão. Os clientes do Amazon DCV precisam dessas informações para se conectar à sessão. **Topics** + [ # Noções básicas sobre sessões do Amazon DCV ](managing-sessions-intro.md) + [ # Usar a ferramenta da linha de comando para gerenciar sessões ](managing-sessions-cli.md) + [ # Iniciar sessões do Amazon DCV ](managing-sessions-start.md) + [ # Interromper sessões do Amazon DCV ](managing-sessions-lifecycle-stop.md) + [ # Visualizar sessões do Amazon DCV ](managing-sessions-lifecycle-view.md) + [ # Gerenciar sessões ativas do Amazon DCV ](managing-running-session.md) + [ # Configurar o fuso horário da sessão ](managing-session-time-zone.md) + [ # Gerenciar a tela em branco no Linux ](managing-screen-blanking.md) + [ # Fazer uma captura de tela em uma sessão do Amazon DCV ](managing-sessions-lifecycle-screenshot.md) # Noções básicas sobre sessões do Amazon DCV O Amazon DCV oferece dois tipos de sessões: sessões de console e sessões virtuais. A tabela a seguir resume as diferenças entre os dois tipos de sessões. | Tipo de sessão | Suporte | Várias sessões | Permissões obrigatórias | Captura de tela direta | Suporte a OpenGL acelerado por GPU | | --- | --- | --- | --- | --- | --- | | Console | Servidores Amazon DCV Linux, macOS e Windows | Não, somente uma sessão de console é permitida em cada servidor | Somente o usuário administrador pode iniciar e fechar sessões | Sim | Sim, sem software adicional | | Virtual | Somente servidores Amazon DCV do Linux | Sim, várias sessões virtuais são permitidas em um único servidor | Qualquer usuário pode iniciar e fechar sessões | Não, um servidor X dedicado (Xdcv) é executado para cada sessão virtual. A tela é capturada do servidor X. | Sim, mas requer o pacote DCV-GL | **nota** Você não pode executar sessões do console e sessões virtuais no mesmo servidor Amazon DCV ao mesmo tempo. ## Sessões do console As sessões de console são compatíveis com servidores Amazon DCV Windows, Linux e macOS. Se você estiver usando um servidor Amazon DCV para Windows ou macOS, só poderá usar sessões de console. Somente uma sessão do console pode ser hospedada no servidor Amazon DCV por vez. As sessões do console são criadas e gerenciadas pelo administrador nos servidores Windows Amazon DCV e pelo usuário raiz nos servidores Amazon DCV Linux e macOS. Com as sessões do console, o Amazon DCV captura diretamente o conteúdo da tela da área de trabalho. Se o servidor estiver configurado com uma GPU, as sessões de console do Amazon DCV terão acesso direto à GPU. ## Sessões virtuais Sessões virtuais são compatíveis apenas com servidores Amazon DCV do Linux. Você pode hospedar várias sessões virtuais no mesmo servidor Amazon DCV ao mesmo tempo. As sessões virtuais são criadas e gerenciadas pelos usuários do Amazon DCV. Os usuários do Amazon DCV só podem gerenciar as sessões que eles mesmos criaram. O usuário-raiz pode gerenciar todas as sessões virtuais que estão atualmente em execução no servidor Amazon DCV. Com sessões virtuais, o Amazon DCV inicia uma instância do servidor X, `Xdcv`, e executa um ambiente de desktop dentro do servidor X. O Amazon DCV inicia uma nova instância do servidor X dedicada para cada sessão virtual. Cada sessão virtual usa a exibição fornecida pela instância do servidor X. **nota** Embora o Amazon DCV garanta que cada sessão virtual tenha uma exibição `Xdcv` independente, muitos outros recursos do sistema, incluindo arquivos na pasta inicial do usuário, serviços de D-Bus e dispositivos, são por usuário e, portanto, serão compartilhados e ficarão acessíveis em várias sessões virtuais para o mesmo usuário. Você não deve executar várias sessões virtuais no mesmo servidor Amazon DCV para o mesmo usuário ao mesmo tempo, a menos que tenha configurado seu sistema operacional para atenuar possíveis preocupações sobre os recursos compartilhados. Se o `dcv-gl` pacote estiver instalado e licenciado, as sessões virtuais do Amazon DCV compartilharão o acesso ao servidor. GPUs Para compartilhar o OpenGL com base em hardware em várias sessões virtuais, você deve conectar uma instância do servidor X virtual à GPU configurando o arquivo `dcv-gl.conf`. # Usar a ferramenta da linha de comando para gerenciar sessões Uso da ferramenta da linha de comandos do Amazon DCV O servidor Amazon DCV inclui uma ferramenta de linha de comandos que pode ser usada para iniciar, interromper e exibir sessões do Amazon DCV. ## Usar a ferramenta de linha de comandos em um servidor Amazon DCV do Windows Para usar a ferramenta de linha de comandos em um servidor Amazon DCV do Windows, execute os comandos do diretório de instalação do Amazon DCV ou adicione o diretório do Amazon DCV à variável de ambiente PATH. Se você adicionar o diretório do Amazon DCV à variável de ambiente PATH, poderá usar os comandos de qualquer diretório. **Para usar a ferramenta de linha de comandos do diretório de instalação do Amazon DCV** Navegue até a pasta na qual o arquivo `dcv.exe` está localizado, `C:\Program Files\NICE\DCV\Server\bin\` por padrão, e abra uma janela de prompt de comando. Ou você pode especificar o caminho completo ao executar um comando de um diretório diferente. ``` "C:\> Program Files\NICE\DCV\Server\bin\dcv.exe" list-sessions ``` **Para adicionar o diretório do Amazon DCV à variável de ambiente PATH** 1. No gerenciador de arquivos, clique com o botão direito do mouse em **Este PC** e escolha **Propriedades**. 1. Escolha **Configurações de sistema avançadas**. 1. Na aba **Avançado**, selecione **Variáveis de ambiente**. 1. Na seção **Variáveis do sistema**, selecione a variável **Path** e escolha **Editar**. 1. Escolha **Novo** e especifique o caminho completo para a pasta `bin` no diretório de instalação do Amazon DCV (por exemplo, `C:\Program Files\NICE\DCV\Server\bin\`). 1. Escolha **OK** e feche a janela Variáveis de ambiente. ## Usar a linha de comandos em um servidor Amazon DCV do Linux Em servidores Amazon DCV do Linux, a ferramenta da linha de comandos é configurada automaticamente na variável de ambiente `$PATH`. Você pode usar a ferramenta em qualquer pasta. Abra uma janela de terminal e digite o comando a ser executado. ## Usando a linha de comando em um servidor macOS Amazon DCV Nos servidores macOS Amazon DCV, a ferramenta de linha de comando é configurada automaticamente na `$PATH` variável de ambiente. Você pode usar a ferramenta em qualquer pasta. Abra uma janela de terminal e digite o comando a ser executado. ## Uso da ferramenta de linha de comando A tabela a seguir abrange as opções de ferramentas de linha de comandos disponíveis. Esta lista pode ser recuperada usando `--help` ao chamar `dcv`. Para obter mais informações sobre como usar cada comando, passe `--help` após o comando para o qual você gostaria de obter informações de uso. Por exemplo: `dcv create-session --help`. | Command | Description | | --- | --- | | `create-session` | Criar uma sessão do DCV | | `close-session` | Fechar uma sessão ativa do DCV | | `describe-session` | Descrever uma sessão do DCV | | `list-sessions` | Listar as sessões ativas do DCV | | `list-connections` | Listar as conexões do cliente para uma sessão do DCV | | `close-connection` | Fechar uma conexão de cliente ativa | | `get-screenshot` | Obter uma captura de tela do console do DCV | | `set-display-layout` | Definir o layout de exibição de uma sessão ativa do DCV | | `set-name` | Definir nome para uma sessão do DCV | | `set-permissions` | Definir permissões de uma sessão ativa do DCV | | `set-storage-root` | Definir raiz de armazenamento de uma sessão ativa do DCV | | `reload-licenses` | Forçar o recarregamento das licenças para todas as sessões em execução | | `get-config` | Obter configuração do servidor | | `list-endpoints` | Listar os endpoints do DCV | | `set-config` | Definir configuração do servidor | | `version` | Mostrar a versão do DCV | | `help` | Mostrar ajuda | # Iniciar sessões do Amazon DCV Iniciar as sessões 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. ------ # Interromper sessões do Amazon DCV Encerramento de sessões Uma sessão de console só pode ser interrompida pelo administrador nos servidores Windows Amazon DCV e pelo usuário root nos servidores Amazon DCV Linux e macOS. Uma sessão virtual em um servidor Amazon DCV do Linux só pode ser interrompida pelo usuário-raiz ou pelo usuário do Amazon DCV que a criou. **nota** Interromper uma sessão fecha todos os aplicativos que estão sendo executados na sessão. Para interromper um console ou uma sessão virtual em um servidor Amazon DCV Windows, Linux ou macOS, use o `dcv close-session` comando e especifique o ID exclusivo da sessão. **Topics** + [ ## Sintaxe ](#managing-sessions-lifecycle-stop-syntax) + [ ## Exemplo ](#example) ## Sintaxe ``` dcv close-session session-id ``` ## Exemplo Por exemplo, o comando a seguir encerra uma sessão com a ID exclusiva `my-session`: ``` dcv close-session my-session ``` # Visualizar sessões do Amazon DCV Visualizar sessões O administrador em um servidor Amazon DCV do Windows ou o usuário-raiz em um servidor Amazon DCV do Linux pode visualizar todas as sessões ativas em execução no servidor. Os usuários do Amazon DCV só podem visualizar as sessões que eles mesmos criaram. **Topics** + [ ## Visualizar todas as sessões ativas ](#list-all) + [ ## Visualizar uma sessão ativa específica ](#view-specific) ## Visualizar todas as sessões ativas Para listar as sessões ativas virtuais ou de console em um servidor Amazon DCV do Windows ou Linux, use o comando `dcv list-sessions`. **Topics** + [ ### Sintaxe ](#list-all-syntax) + [ ### Output ](#output) ### Sintaxe ``` dcv list-sessions ``` ### Output O comando retorna uma lista de sessões ativas no seguinte formato. ``` Session: session-id (owner:session-owner type:virtual|console name:'my session') ``` ## Visualizar uma sessão ativa específica Para visualizar informações sobre uma sessão, use o comando `dcv describe-session` e especifique a ID exclusiva da sessão. **Topics** + [ ### Sintaxe ](#view-specific-syntax) + [ ### Output ](#output) ### Sintaxe ``` $ dcv describe-session session_id ``` ### Output Na saída de exemplo a seguir, o elemento `display-layout` indica que o layout de exibição da sessão está definido para usar duas telas de 800 x 600. Delas, a segunda tela é deslocada x = 800 (à direita) da primeira tela. ``` 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 ``` Também é possível incluir a opção `--json` (ou `-j`) para forçar o comando a retornar a saída no formato JSON. A saída JSON fornece detalhes adicionais sobre a sessão. ``` $ dcv describe-session session-id --json ``` Veja a seguir um exemplo de saída 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 } ] } ``` # Gerenciar sessões ativas do Amazon DCV Gerenciar sessões ativas Depois que um cliente faz logon e começa a usar uma sessão do DCV, a sessão é considerada ativa. Enquanto uma sessão estiver ativa, você ainda poderá executar determinadas tarefas de gerenciamento. Esta seção fornece as informações necessárias sobre como gerenciar os parâmetros dessas sessões enquanto elas ainda estão em uso pelo cliente. **Topics** + [Gerenciar o armazenamento de sessões](managing-session-storage.md) + [Gerenciar a autorização da sessão](managing-session-perms.md) + [Gerenciar o layout de exibição da sessão](managing-session-display.md) + [ # Gerenciar o nome da sessão ](managing-session-name.md) + [ # Descobrir e interromper sessões ociosas ](stop-idle-sessions.md) # Gerenciar o armazenamento de sessão do Amazon DCV Gerenciar o armazenamento de sessões O armazenamento de sessões é um diretório no servidor Amazon DCV que os clientes podem acessar quando estão conectados a uma determinada sessão do Amazon DCV. Se o armazenamento de sessões estiver habilitado no servidor Amazon DCV, será possível usar o comando `dcv set-storage-root` para especificar o diretório no servidor a ser usado para armazenamento de sessões. Para obter mais informações sobre como habilitar o armazenamento de sessões no servidor Amazon DCV, consulte [Habilitar armazenamento da sessão](manage-storage.md). Para definir o caminho do armazenamento de sessões, use o comando `dcv set-storage-root` e especifique o ID da sessão e o caminho para o diretório a ser usado. **Topics** + [ ## Sintaxe ](#managing-session-storage-syntax) + [ ## Opções ](#managing-session-storage-options) + [ ## Exemplos ](#session-storage-example) ## Sintaxe ``` dcv set-storage-root --session session_id /path_to/directory ``` Para o caminho do diretório, é possível usar `%home%` para especificar o diretório inicial do usuário que está conectado no momento. Por exemplo, o caminho `%home%/storage/` é resolvido para `c:\Users\username\storage\` em servidores do Windows. O resultado é `$HOME/storage/` em servidores do Linux. **nota** O `storage-root` valor deve ser um caminho absoluto no macOS. ## Opções As opções a seguir podem ser usadas com o comando `dcv set-storage-root` **`--session`** O ID da sessão para o qual especificar o diretório de armazenamento. Tipo: String Obrigatório: Sim ## Exemplos **Exemplo de servidor Amazon DCV do Windows** O exemplo a seguir define o caminho de armazenamento como `c:\session-storage` para uma sessão com um ID de sessão de `my-session`. ``` C:\> dcv set-storage-root --session my-session c:\session-storage ``` **Exemplo de servidor Amazon DCV do Linux** O exemplo a seguir define o caminho de armazenamento como um diretório chamado `session-storage` no diretório inicial do usuário atual, para uma sessão com um ID de sessão de `my-session`. ``` $ dcv set-storage-root --session my-session %home%/session-storage/ ``` # Gerenciar a autorização da sessão do Amazon DCV Gerenciar a autorização da sessão A autorização é usada para conceder ou negar permissões de clientes do Amazon DCV a recursos específicos do Amazon DCV. Normalmente, a autorização é configurada quando uma sessão do Amazon DCV é iniciada. No entanto, é possível editar as permissões para uma sessão em execução. Para obter mais informações sobre a autorização do Amazon DCV, consulte [Configurar autorização do Amazon DCV](security-authorization.md). Para modificar as permissões de uma sessão em execução, use o comando `dcv set-permissions`. **Topics** + [ ## Sintaxe ](#managing-session-perms-syntax) + [ ## Opções ](#managing-session-perms-options) + [ ## Exemplos ](#session-perms-example) ## Sintaxe ``` dcv set-permissions --session session-id --none | --reset-builtin | --file /path_to/permissions_file ``` Você precisa especificar `--none`, `--reset-builtin` ou `--file`. ## Opções As opções a seguir podem ser usadas com o comando `dcv set-permissions`. **--session** Especifica a ID da sessão para a qual as permissões serão definidas. **--reset-builtin** Redefine as permissões da sessão para as permissões de sessão padrão. As permissões padrão concedem apenas ao proprietário da sessão acesso total a todos os recursos. **--none** Revoga todas as permissões da sessão. **--file** Especifica o caminho para um arquivo de permissões personalizadas. Se o arquivo especificado estiver vazio, todas as permissões serão revogadas. Para obter mais informações sobre como criar um arquivo de permissões personalizado, consulte [Noções básicas sobre arquivos de permissões](security-authorization-file-create.md). ## Exemplos **Exemplo 1 — Revogar todas as permissões** O exemplo a seguir revoga todas as permissões de cliente de uma sessão com um ID de `my-session`. ``` C:\> dcv set-permissions --session my-session --none ``` **Exemplo 2 — Especificar as permissões personalizadas** O exemplo a seguir especifica um arquivo de permissões personalizado chamado `perm-file.txt` para uma sessão com uma ID `my-session`. Esse arquivo encontra-se no diretório `c:\dcv\`. ``` C:\> dcv set-permissions --session my-session --file c:\dcv\perm-file.txt ``` **Exemplo 3 — Redefinir as permissões** O exemplo a seguir redefine as permissões para os padrões de uma sessão com um ID de `my-session`. ``` C:\> dcv set-permissions --session my-session --reset-builtin ``` # Gerenciar o layout de exibição da sessão do Amazon DCV Gerenciar o layout de exibição da sessão É possível definir o layout de exibição de sessão do Amazon DCV em execução. O layout de exibição especifica a configuração padrão usada quando os clientes se conectam à sessão. No entanto, os clientes podem substituir manualmente o layout usando as configurações do cliente do Amazon DCV ou as configurações de exibição nativas do sistema operacional. Se a configuração de hardware e software do servidor host não for compatível com a resolução especificada ou o número de telas, o servidor NICE DCV não aplicará o layout de exibição especificado. O Amazon DCV pode configurar uma resolução de acordo com as configurações e a configuração do sistema do servidor. + A resolução do cliente Web é limitada por padrão a 1920x1080 (a partir da configuração do servidor web-client-max-head -resolution). + Por padrão, os clientes nativos são limitados a 4096x2160 (de). max-head-resolution Observe que as resoluções disponíveis e o número de monitores dependem da configuração do servidor. Certifique-se de seguir o [guia de pré-requisitos](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing.html) para configurar corretamente o ambiente do sistema e os drivers para melhor desempenho. **nota** Para clientes nativos, é possível usar no máximo quatro monitores. Para clientes web, é possível usar ​​no máximo dois monitores. Resoluções mais altas ou superiores ao número máximo de monitores não são compatíveis com nenhuma configuração. **Topics** + [ ## Acessar o layout de exibição ](#display-restrict) + [ ## Definir o layout de exibição ](#dislay-set) + [ ## Visualizar o layout de exibição ](#dislay-view) ## Acessar o layout de exibição É possível configurar o servidor Amazon DCV para impedir que os clientes solicitem layouts de exibição que estejam fora de um intervalo especificado. Para restringir as alterações de layout de exibição, configure os seguintes parâmetros do servidor Amazon DCV. + [`enable-client-resize`](config-param-ref.md#paramref.display.enable-client-resize): para evitar que os clientes alterem o layout de exibição, defina esse parâmetro como `false`. + [`min-head-resolution`](config-param-ref.md#paramref.display.min-head-resolution) e [`max-head-resolution`](config-param-ref.md#paramref.display.max-head-resolution)—Especifica as resoluções mínima e máxima permitidas, respectivamente. + [`web-client-max-head-resolution`](config-param-ref.md#paramref.display.web-client-max-head-resolution)—Especifica a resolução máxima permitida para clientes de navegadores da Web. A limitação `max-head-resolution` é aplicada sobre a limitação `web-client-max-head-resolution`. Por padrão, a resolução máxima para clientes de navegadores da Web é 1920 x 1080. Especificar uma resolução mais alta pode causar problemas de desempenho, dependendo do navegador da Web e das especificações do computador cliente. + [`max-num-heads`](config-param-ref.md#paramref.display.max-num-heads)—Especifica o número máximo de exibições. + `max-layout-area`— Especifica o número máximo de pixels permitido para a área da tela. As solicitações nas quais a área total da tela (expressa em pixels) excede o valor especificado são ignoradas. Para obter mais informações sobre esses parâmetros, consulte [Parâmetros do `display`](config-param-ref.md#display) na Referência de parâmetros. ## Definir o layout de exibição **Para configurar o layout de exibição para uma sessão do Amazon DCV em execução** Use o comando `dcv set-display-layout` e especifique a sessão para a qual será definido o layout de exibição e o descritor do layout de exibição. ``` dcv set-display-layout --session session-id display-layout-descriptor ``` O descritor de layout de exibição especifica o número de exibições e o deslocamento de resolução e posição para cada exibição. A descrição deve ser especificada no seguinte formato: ``` widthxheight+|-x-position-offset+|-y-position-offset ``` Se você especificar mais de uma tela, separe os descritores da tela com uma vírgula. Os deslocamentos da posição da tela especificam a posição do canto superior esquerdo da tela em relação à tela 1. Se você não especificar um deslocamento de posição para uma tela, o padrão será x = 0 e y = 0. **Importante** Se você estiver especificando mais de uma tela, lembre-se de definir corretamente o deslocamento de posição para cada tela para evitar sobreposições de tela. Por exemplo, o seguinte descritor de layout de exibição especifica duas telas: + Tela 1: resolução de 1920 x 1080 deslocada para x = 0, y = 0 + Tela 2: resolução de 800 x 600 deslocada para x = 1920, y = 0 para que apareça à direita da tela 1. ![\[Layout de tela com duas telas.\]](http://docs.aws.amazon.com/pt_br/dcv/latest/adminguide/images/eg2.png) ``` 1920x1080+0+0,800x600+1920+0 ``` O descritor de layout de exibição a seguir especifica três telas. + Tela 1: resolução de 1920 x 1080 deslocada para x = 0, y = 0 + Tela 2: resolução de 1920 x 1080 deslocada para x = 1920, y = 0 para que apareça à direita da tela 1. + Tela 3: resolução de 1024 x 768 deslocada para x = -1024, y = 0 para que apareça à esquerda da tela 1. ![\[Layout de tela com três telas.\]](http://docs.aws.amazon.com/pt_br/dcv/latest/adminguide/images/eg1.png) ``` 1920x1080+0+0,1920x1080+1920+0,1024x768-1024+0 ``` ## Visualizar o layout de exibição **Como exibir o layout de exibição de uma sessão** Use o comando `dcv describe-session` e revise o elemento `display layout` na saída. Para obter mais informações, consulte [Visualizar sessões do Amazon DCV](managing-sessions-lifecycle-view.md). # Gerenciar o nome da sessão É possível alterar o nome de uma sessão em execução a qualquer momento. Você pode usar o nome específico da sessão para identificar rapidamente uma sessão com base em seu nome. Os nomes das sessões não precisam ser exclusivos nas sessões em execução. Para alterar o nome de uma sessão em execução, use o comando `dcv set-name`. **Topics** + [ ## Sintaxe ](#managing-session-name-syntax) + [ ## Opções ](#managing-session-name-options) + [ ## Exemplos ](#example) ## Sintaxe ``` $ dcv set-name --session session_id --none |--name "session-name" ``` Você precisa especificar `--name` ou `--none`. ## Opções As opções a seguir podem ser usadas com o comando `dset-name`. **`--session`** A ID da sessão para a qual o nome será definido. Tipo: String Obrigatório: Sim **`--name`** O nome a ser atribuído à sessão. Especifique essa opção somente se quiser atribuir um nome à sessão. Se quiser remover um nome, omita esse parâmetro. O nome da sessão pode ter até 256 caracteres. Ele pode conter letras, números e caracteres especiais. Se a string especificada exceder 256 caracteres, o comando falhará. Tipo: string Obrigatório: não **`--none`** Especifique esse parâmetro para remover um nome existente de uma sessão. Se você não quiser remover o nome da sessão, omita essa opção. Obrigatório: não ## Exemplos **Exemplo 1—Alterar o nome de uma sessão** O exemplo a seguir define o nome de uma sessão com uma ID `my-session` como `my graphics session`. ``` $ dcv set-name --session my-session --name "my graphics sessions" ``` **Exemplo 2—Remover o nome de uma sessão** O exemplo a seguir remove o nome de uma sessão com um ID `my-session`. ``` $ dcv set-name --session my-session --none ``` # Descobrir e interromper sessões ociosas É possível identificar sessões inativas do Amazon DCV usando o comando da CLI `dcv describe-sessions` com a opção de comando `-j`. Especificar a opção `-j` configura o comando para retornar a saída no formato JSON, que fornece detalhes adicionais sobre a sessão. Por exemplo, o comando a seguir retorna informações sobre uma sessão chamada `my-session`. ``` $ dcv describe-session my-session -j ``` Saída: ``` { "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" } ] } ``` Na saída do comando, o parâmetro `num-of-connections` indica o número de conexões de cliente ativas. Um valor de `0` indica que não há conexões de cliente ativas e que a sessão está inativa no momento. Também é possível usar o parâmetro `last-disconnection-time` para determinar quando a sessão teve uma conexão de cliente ativa pela última vez. É possível criar um trabalho de script ou cron que use essas informações para identificar sessões inativas. É possível parar de usá-las por meio do comando [`dcv close-session`](managing-sessions-lifecycle-stop.md). **nota** Interromper uma sessão fecha todos os aplicativos que estão sendo executados na sessão. # Configurar o fuso horário da sessão O DCV permite que proprietários e usuários da sessão definam o fuso horário da sessão para refletir a localização do servidor DCV ou sua localização atual. Se somente usuários individuais em uma sessão precisarem ter esse recurso, você precisará primeiro definir o parâmetro centralizado para todos os usuários e depois ajustar as permissões dos indivíduos separadamente criando um arquivo de permissões personalizado em [Adicionar permissões](security-authorization-file-create-permission.md). **nota** Esse atributo não está disponível para sessões virtuais do Linux. **nota** No macOS, o redirecionamento de fuso horário é aplicado após o login. **Ativar o redirecionamento de fuso horário** Você pode ativar e desativar esse recurso para todos os usuários em uma sessão específica. 1. Modifique o parâmetro [`enable-timezone-redirection`](config-param-ref.md#paramref.redirection.enable-timezone-redirection) com um dos seguintes valores: + `always-on`: o redirecionamento de fuso horário está sempre ativado. O recurso uto será ativado, e a sessão exibirá as informações de fuso horário do cliente. O usuário não conseguirá desativar o recurso. + `always-off`: o redirecionamento de fuso horário está sempre desativado. O recurso será desativado, e a sessão exibirá as próprias informações de fuso horário. O usuário não conseguirá ativar o recurso. + `client-decides`: o redirecionamento de fuso horário fica ativado por padrão. O recurso da sessão será ativado, a sessão exibirá o fuso horário do cliente, e o usuário terá a opção de desativá-lo, permitindo que o fuso horário do servidor seja exibido. **nota** Essa é a configuração padrão. 1. Reinicie todas as sessões afetadas para que suas alterações apareçam. # Gerenciar a tela em branco no Linux Para sessões de console em um servidor Linux, o DCV apaga a tela local por padrão quando pelo menos um usuário remoto está conectado ao servidor e restaura a saída (também bloqueando a tela) após a desconexão do último usuário remoto. Isso evita que o usuário na proximidade física de um servidor veja a tela e interaja com a sessão remota usando os dispositivos de entrada conectados ao host. Isso pode ser indesejável por motivos de privacidade ou conformidade com as leis locais ao trabalhar remotamente em sessões de console. A entrada local é impedida pela desativação de dispositivos fisicamente conectados, como o teclado e o mouse. Os dispositivos de entrada são desabilitados assim que são conectados ou quando são encontrados habilitados. Analogamente, os dispositivos de entrada são habilitados novamente quando nenhum usuário remoto está conectado, permitindo assim logon e interação local. **Desabilitar a tela em branco e o bloqueio de entrada** A tela em branco pode ser desabilitada usando o seguinte procedimento: 1. Navegue até `/etc/dcv/` e abra o arquivo `dcv.conf` com o editor de texto de sua preferência. 1. Localize `disable-local-console parameter` na seção `[display/linux]`. Para permitir que os monitores conectados localmente permaneçam ativos e mostrem a sessão remota em andamento, bem como permitir a interação por meio de dispositivos conectados localmente, defina `disable-local-console=false`. O valor padrão é `true` (ou seja, tela em branco e bloqueio de entrada ativos). Se não houver um parâmetro `disable-local-console` na seção `[display/linux]`, adicione-o usando o formato a seguir: ``` [display/linux] disable-local-console=false|true ``` 1. Salve e feche o arquivo. 1. [Interrompa](manage-stop.md) e [reinicie](manage-start.md) o servidor Amazon DCV. **Impedir que dispositivos de entrada selecionados sejam desabilitados** Dispositivos específicos podem ser configurados para permanecerem ativados. Dispositivos de entrada cujos nomes começam com `DCV ` (preste atenção ao espaço após o nome) nunca serão desabilitados, independentemente do valor da configuração `display-local-console`. Para renomear dispositivos de entrada, consulte este guia: [Habilitar caneta](enable-stylus.md). # Fazer uma captura de tela em uma sessão do Amazon DCV Fazer uma captura de tela Você pode usar o comando `dcv get-screenshot` para obter uma captura de tela da área de trabalho para a sessão em execução. ## Sintaxe ``` dcv get-screenshot --max-width pixels --max-height pixels --format JPEG|PNG --primary --json --output /path_to/destination session_name ``` ## Opções **`--max-width`** Especifica a largura máxima, em pixels, da captura de tela. Se você não especificar uma largura ou altura, a captura de tela usará a resolução de exibição da sessão. Se você especificar somente uma altura, a largura será automaticamente escalada para manter a proporção. Tipo: inteiro Obrigatório: não **`--max-height`** Especifica a altura máxima, em pixels, da captura de tela. Se você não especificar uma largura ou altura, a captura de tela usará a resolução de exibição da sessão. Se você especificar somente uma largura, a altura será automaticamente escalada para manter a proporção. Tipo: inteiro Obrigatório: não **`--format`** O formato do arquivo da captura de tela. Atualmente, apenas os formatos `JPEG` e `PNG` são compatíveis. Se você especificar tipos de arquivo conflitantes para as opções `--format` e `--output`, o valor especificado para `--format` terá prioridade. Por exemplo, se você especificar `--format JPEG` e `--output myfile.png`, o Amazon DCV cria um arquivo de imagem JPEG. Tipo: string Valores permitidos: `JPEG` \$1 `PNG` Obrigatório: não **`--primary`** Indica se será obtida uma captura de tela somente da exibição principal. Para obter uma captura de tela somente da exibição principal, especifique `--primary`. Para obter uma captura de tela de todas as exibições, omita essa opção. Se você optar por obter uma captura de tela de todas as exibições, todas elas serão combinadas em uma única captura de tela. Obrigatório: não **`--json`, `-j`** Indica se a saída será entregue no formato JSON codificado em base64. Para obter a saída JSON, especifique `--json`. Caso contrário, omita-o. Obrigatório: não **`--output`, `-o`** Especifica o caminho de destino, o nome do arquivo e o tipo de arquivo para a captura de tela. Por exemplo, para Windows, especifique `c:\directory\filename.format` e, para Linux, especifique `/directory/filename.format`. O formato deve ser `.png` ou `.jpeg`. Se você especificar tipos de arquivo conflitantes para as opções `--format` e `--output`, o valor especificado para `--format` terá prioridade. Por exemplo, se você especificar `--format JPEG` e `--output myfile.png`, o Amazon DCV cria um arquivo de imagem JPEG. Tipo: string Obrigatório: não ## Exemplos **Exemplo 1** O comando de exemplo a seguir obtém uma captura de tela de uma sessão chamada `my-session`. A captura de tela usa a resolução do servidor. ``` dcv get-screenshot --output myscreenshot.png my-session ``` **Exemplo 2** O comando de exemplo a seguir faz uma captura de tela com `200` pixels de largura por `100` pixels de altura. Isso vem de uma sessão chamada `my-session`. Ela salva a captura de tela no diretório atual com o nome de arquivo `myscreenshot.png`. ``` dcv get-screenshot --max-width 200 --max-height 100 --output myscreenshot.png my-session ``` **Exemplo 3** O comando de exemplo a seguir faz uma captura de tela de uma sessão chamada `my-session`. A captura de tela é somente da exibição principal. Ela salva a captura de tela no diretório atual e a nomeia como `myscreenshot.png`. ``` dcv get-screenshot --primary --output myscreenshot.jpeg my-session ``` **Exemplo 4** O comando de exemplo a seguir obtém uma captura de tela de uma sessão chamada `my-session`. O comando gera o arquivo codificado em base64 e no formato JSON. ``` dcv get-screenshot --json --format png my-session ```