Fichier de configuration des scripts de session - Amazon AppStream 2.0

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Fichier de configuration des scripts de session

Pour localiser le fichier de configuration des scripts de session dans une instance Windows, accédez à C : \ \ AppStream SessionScripts \ config.json. Sur une instance Linux, accédez à /opt/appstream/ SessionScripts /config.json. Le format du fichier est le suivant.

Note

Le fichier de configuration est au format .json. Vérifiez que tout le texte que vous saisissez dans ce fichier est au format .json valide.

{
  "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
  }
}

Vous pouvez utiliser les paramètres suivants dans le fichier de configuration des scripts de session.

SessionStart/SessionTermination

Les scripts de session s'exécutent dans l'événement de session approprié, en fonction du nom de l'objet.

Type : chaîne

Obligatoire : non

Valeurs autorisées : SessionStart, SessionTermination

WaitingTime

Durée maximale en secondes des scripts de session.

Type : entier

Obligatoire : non

Contraintes : la durée maximale ne peut pas dépasser 60 secondes. Si l'exécution des scripts de session n'est pas terminée au terme de ce délai, elle s’arrête. Si vous avez besoin d'un script pour continuer l’exécution, lancez-le comme un processus distinct.

Executables

Détails sur les scripts de session à exécuter.

Type : chaîne

Obligatoire : oui

Contraintes : le nombre maximum de scripts qui peuvent s'exécuter par événement de session est de 2 (un pour le contexte de l'utilisateur et l'autre pour le contexte du système).

Context

Le contexte dans lequel le script de session doit être exécuté.

Type : chaîne

Obligatoire : oui

Valeurs autorisées : user, system

Filename

Le chemin d'accès complet au script de session qui doit être exécuter. Si ce paramètre n'est pas spécifié, le script de session n'est pas exécuté.

Type : chaîne

Obligatoire : non

Contraintes : la longueur maximale du nom de fichier et du chemin d'accès complet est de 1 000 caractères.

Valeurs autorisées :.bat,.exe, .sh

Note

Vous pouvez également utiliser des PowerShell fichiers Windows. Pour de plus amples informations, veuillez consulter Utilisation de PowerShell fichiers Windows.

Arguments

Les arguments pour votre script de session ou votre fichier exécutable.

Type : chaîne

Obligatoire : non

Contraintes de longueur : la longueur maximale est de 1 000 caractères.

S3LogEnabled

Lorsque la valeur de ce paramètre est définie sur True, un compartiment S3 est créé dans votre compte Amazon Web Services pour stocker les journaux créés par le script de session. Par défaut, cette valeur indique True. Pour en savoir plus, consultez la section Journalisation de la sortie du script de session plus loin dans cette rubrique.

Type : valeur booléenne

Obligatoire : non

Valeurs autorisées : True, False