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 ativas do Amazon DCV 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 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 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 É 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.