Arquivo de configuração de scripts de sessão - Amazon AppStream 2.0

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

Arquivo de configuração de scripts de sessão

Para localizar o arquivo de configuração dos scripts de sessão em uma instância do Windows, navegue até C:\\ AppStreamSessionScripts\ config.json. Em uma instância Linux, navegue até/opt/appstream/SessionScripts/config.json. O arquivo é formatado da maneira a seguir.

nota

O arquivo de configuração está no formato .json. Verifique se qualquer texto que você digitar nesse arquivo está no formato .json válido.

{
  "SessionStart": {
    "executables": [
      {
        "context": "system",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      },
      {
        "context": "user",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      }
    ],
    "waitingTime": 30
  },
  "SessionTermination": {
    "executables": [
      {
        "context": "system",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      },
      {
        "context": "user",
        "filename": "",
        "arguments": "",
        "s3LogEnabled": true
      }
    ],
    "waitingTime": 30
  }
}

Você pode usar os seguintes parâmetros no arquivo de configuração de scripts de sessão.

SessionStart/SessionTermination

Os scripts de sessão devem ser executados no evento de sessão apropriado com base no nome do objeto.

Tipo: string

Obrigatório: não

Valores permitidos: SessionStart, SessionTermination

WaitingTime

A duração máxima dos scripts de sessão em segundos.

Tipo: inteiro

Obrigatório: não

Restrições: a duração máxima é de 60 segundos. Se os scripts de sessão não forem concluídos dentro desse período, eles serão interrompidos. Se você precisar que um script continue em execução, inicie-o como um processo separado.

Executables

Os detalhes dos scripts de sessão para executar.

Tipo: string

Obrigatório: Sim

Restrições: o número máximo de scripts que podem ser executados por evento de sessão é 2 (um para o contexto do usuário e um para o contexto do sistema).

Context

O contexto no qual executar o script de sessão.

Tipo: string

Obrigatório: Sim

Valores permitidos: user, system

Filename

O caminho completo para o script de sessão a ser executado. Se esse parâmetro não for especificado, o script de sessão não será executado.

Tipo: string

Obrigatório: não

Restrições: o comprimento máximo do nome do arquivo e do caminho completo é 1.000 caracteres.

Valores permitidos: .bat, .exe, .sh

nota

Você também pode usar PowerShell arquivos do Windows. Para obter mais informações, consulte Usando PowerShell arquivos do Windows.

Arguments

Os argumentos do script de sessão ou arquivo executável.

Tipo: string

Obrigatório: não

Restrições de tamanho: o comprimento máximo é de 1.000 caracteres.

S3LogEnabled

Quando o valor desse parâmetro for definido como True, um bucket do S3 será criado em sua conta da Amazon Web Services para armazenar os logs criados pelo script de sessão. Por padrão, esse valor é definido como True. Para obter mais informações, consulte a seção Registro da saída do script de sessão mais adiante neste tópico.

Tipo: booliano

Obrigatório: não

Valores permitidos: True, False