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.
CLIOpérations de l'assistant d'imagerie pour créer et gérer votre image Amazon AppStream 2.0
Cette section décrit les CLI opérations de l'Assistant Image que vous pouvez utiliser pour créer et gérer votre image AppStream 2.0.
Sur les générateurs d'images Windows, le fichier exécutable qui inclut l'interface de ligne de commande se trouve à l'emplacement suivant : C:\Program Files \ Amazon \ Photon \ ConsoleImageBuilder \ Image-Assistant.exe. Pour votre commodité, ce fichier exécutable est inclus dans la PATH variable Windows. Cela vous permet d'appeler les CLI opérations de l'Assistant Image sans spécifier le chemin absolu vers le fichier exécutable. Pour appeler ces opérations, tapez la commande image-assistant.exe.
Sur les constructeurs d'images Linux, l'outil d'assistant d'image se trouve dans /usr/local/appstream/image-assistant/, avec un lien symbolique dans /bin/AppStreamImageAssistant. AppStreamImageAssistant
Opération help
Récupère la liste de toutes les CLI opérations d'Image Assistant. Pour chaque opération de la liste, la description et la syntaxe d'utilisation sont fournies. Pour afficher l'aide relative à une opération spécifique, tapez le nom de l'opération et spécifiez le paramètre -help. Par exemple :
add-application --help
Résumé
help
Sortie
Imprime sur la sortie standard la liste des opérations disponibles avec une description de leur fonction.
Opération add-application
Ajoute l'application à la liste des applications pour les utilisateurs de la AppStream version 2.0. Les applications de cette liste sont incluses dans le catalogue d'applications. Le catalogue d'applications s'affiche pour les utilisateurs lorsqu'ils se connectent à une session de streaming AppStream 2.0.
Note
Si vous devez apporter des modifications à la configuration d’une application, supprimez-la, puis ajoutez-la avec les paramètres mis à jour.
Résumé
add-application --name <value> --absolute-app-path <value> [--display-name <value>] [--absolute-icon-path <value>] [--working-directory <value>] [--launch-parameters <""-escaped value>] [--absolute-manifest-path <value>]
Options
--name(chaîne)-
Nom unique de l'application. La longueur maximale est de 256 caractères. Vous pouvez ajouter jusqu'à 50 applications. Vous ne pouvez pas utiliser d’espace.
--absolute-app-path(chaîne)-
Chemin absolu vers le fichier exécutable, le fichier de commandes ou le script pour l'application. Le chemin doit pointer vers un fichier valide.
--display-name(chaîne)-
Nom à afficher pour l'application dans le catalogue d'applications. Si vous ne spécifiez pas de nom d'affichage, la AppStream version 2.0 crée un nom dérivé du nom du fichier exécutable. Le nom est créé sans l'extension de fichier et avec des traits de soulignement à la place des espaces. La longueur maximale est de 256 caractères.
--absolute-icon-path(chaîne)-
Chemin absolu vers l'icône de l'application. Le chemin doit pointer vers un fichier d'icône valide de type .jpg, .png ou .bmp. Les dimensions maximales sont : 256 px x 256 px. Si vous ne spécifiez pas de chemin d'accès, l'icône par défaut pour le fichier exécutable est utilisée, si elle est disponible. Si aucune icône par défaut n'est disponible pour le fichier exécutable, une icône d'application AppStream 2.0 par défaut est utilisée.
--working-directory(chaîne)-
Répertoire de travail initial pour l'application lorsque celle-ci est lancée.
--absolute-manifest-path(chaîne)-
Chemin d'accès à un nouveau fichier texte séparé par des lignes. Le fichier spécifie le chemin absolu des fichiers à optimiser avant que l'instance de flotte soit disponible à un utilisateur pour le streaming. Le chemin doit pointer vers un fichier texte valide.
Sortie de message
| Code de sortie | Message imprimé sur la sortie standard | Description |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | L'application a été ajoutée avec succès. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | {"status": 1, "message": "Unable to add more than 50 apps to the catalog."} | L'application n'a pas pu être ajoutée car le nombre maximum d'applications pouvant être ajoutées au catalogue d'applications AppStream 2.0 est de 50. |
| 1 | {"status": 1, "message": "Name is not unique"} | Une application portant ce nom existe déjà dans le catalogue d'applications AppStream 2.0. |
| 1 | {"status » : 1, « message » : « Fichier introuvable (absolute-app-path)"} | Le fichier spécifié pour absolute-app-path est introuvable. |
| 1 | {"status": 1, "message": "Unsupported file extension"} | Le paramètre Absolute-app-path prend uniquement en charge les types de fichiers suivants : .exe et .bat. |
| 1 | {"status": 1, "message": "Directory not found (répertoire_travail)" | Le répertoire spécifié pour working-directory est introuvable. |
| 1 | {"status": 1, "message": "Optimization-manifest not found: <nom_fichier>"} | Le fichier spécifié pour optimization-manifest est introuvable. |
| 1 | {"status": 1, "message": "File not found: <nom_fichier>"} | Un fichier spécifié dans le manifeste d'optimisation est introuvable. |
| 255 | {"status": 255, "message": <message_erreur>} | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le Centre AWS Support |
Opération remove-application
Supprime une application de la liste des applications pour l'image AppStream 2.0. L'application n'est ni désinstallée ni modifiée, mais les utilisateurs ne pourront pas la lancer depuis le catalogue d'applications AppStream 2.0.
Résumé
remove-application --name <value>
Options
--name(chaîne)-
Identifiant unique de l'application à supprimer.
Sortie de message
| Code de sortie | Message imprimé sur la sortie standard | Description |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | L'application a été supprimée avec succès. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | {"status": 1, "message": "App not found"} | L'application spécifiée est introuvable dans le catalogue d'applications AppStream 2.0. |
| 255 | {"status": 255, "message": <message_erreur>} | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le Centre AWS Support |
Opération list-applications
Répertorie toutes les applications spécifiées dans le catalogue d'applications.
Résumé
list-applications
Sortie de message
| Code de sortie | Message imprimé sur la sortie standard | Description |
|---|---|---|
| 0 | {"status": 0, "message": "Success", "applications": [ {..app1.. }, { ..app2.. }]} | Liste des applications du catalogue d'applications AppStream 2.0. |
| 255 | {"status": 255, "message": <message_erreur>} | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le Centre AWS Support |
Opération update-default-profile
Copie le profil de l’utilisateur Windows spécifié dans le profil d’utilisateur Windows par défaut. Les nouveaux utilisateurs qui diffusent héritent des paramètres stockés dans le profil spécifié.
Note
Cette opération n'est pas prise en charge par l'CLIoutil d'assistant d'imagerie Linux.
Résumé
update-default-profile [--profile <value>]
Options
--profile(chaîne)-
Nom de l'utilisateur dont le profil Windows Windows sera copié dans le profil utilisateur Windows par défaut. Utilisez le format suivant pour le nom :
"<domaine>\<nom_utilisateur>"
Si votre instance Image Builder n’est pas jointe à un domaine Microsoft Active Directory, entrez un point « . » pour le domaine. Si vous ne spécifiez aucun utilisateur, le compte utilisateur du modèle AppStream 2.0 est utilisé.
Sortie de message
| Code de sortie | Message imprimé sur la sortie standard | Description |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | Les paramètres utilisateur ont été copiés dans le profil Windows par défaut. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <chemin>. <raison>"} | Les paramètres utilisateur n'ont pas pu être copiés, car un fichier ou un dossier était indisponible. |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | Un utilisateur du domaine Microsoft Active Directory a été spécifié, mais l’instance Image Builder n’est jointe à aucun domaine Active Directory. |
| 255 | {"status": 255, "message": <message_erreur>} | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le Centre AWS Support |
Opération reset-user-profile
Supprime le profil utilisateur Windows pour l'utilisateur spécifié.
Note
Cette opération n'est pas prise en charge par l'CLIoutil d'assistant d'imagerie Linux.
Résumé
reset-user-profile [--profile <value>]
Options
--profile(chaîne)-
Nom de l'utilisateur Windows dont le profil Windows sera supprimé. Utilisez le format suivant pour le nom :
"<domaine>\<nom_utilisateur>"
Si votre instance Image Builder n’est pas jointe à un domaine Microsoft Active Directory, entrez un point « . » pour le domaine.
Sortie de message
| Code de sortie | Message imprimé sur la sortie standard | Description |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | Les paramètres de l'utilisateur spécifié ont été supprimés avec succès. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | {"status": 1, "message": "Unable to copy file or folder: <chemin>. <raison>"} | Les paramètres de l'utilisateur n'a pas pu être réinitialisés, car un fichier ou un dossier était indisponible. |
| 1 | {"status": 1, "message": "Cannot copy a domain user when not joined to a domain""} | Un utilisateur du domaine Microsoft Active Directory a été spécifié, mais l’instance Image Builder n’est jointe à aucun domaine Active Directory. |
| 255 | {"status": 255, "message": <message_erreur>} | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le Centre AWS Support |
Opération create-image
Démarre le flux de travail de création d'images, qui produit une image AppStream 2.0 qui peut être utilisée pour les flottes AppStream 2.0.
Résumé
create-image --name <value> [--description <value>] [--display-name <value>] [--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog] [--use-latest-agent-version] | [--no-use-latest-agent-version] [--tags <value>] [--dry-run]
Options
--name(chaîne)-
Nom de l'image AppStream 2.0. Le nom doit être unique au sein du compte et de la AWS région Amazon Web Services. La longueur maximale est de 100 caractères. Les caractères autorisés sont les suivants :
a-z, A-Z, 0-9, traits de soulignement (_), tirets (-) et points (.)
Le nom d'image ne peut pas commencer par un des préfixes suivants : « aws », « appstream » et « amazon ». Ces préfixes sont réservés pour une utilisation AWS .
--description(chaîne)-
Description à afficher pour l'image. La longueur maximale est de 256 caractères.
--display-name(chaîne)-
Nom à afficher pour l'image. La longueur maximale est de 256 caractères.
--enable-dynamic-app-catalog|--no-enable-dynamic-app-catalog-
Active ou désactive la prise en charge de l'infrastructure d'applications dynamiques AppStream 2.0. Si vous ne spécifiez aucun paramètre, la prise en charge du cadre d’application dynamique n'est pas activée.
L'infrastructure d'applications dynamiques fournit des opérations au sein d'une instance de streaming AppStream 2.0 que vous pouvez utiliser pour créer un fournisseur d'applications dynamiques. Les fournisseurs d'application dynamique peuvent utiliser ces opérations pour modifier le catalogue d'applications auquel vos utilisateurs peuvent accéder en temps réel. Pour de plus amples informations, veuillez consulter Utiliser le framework d'applications dynamiques AppStream 2.0 pour créer un fournisseur d'applications dynamiques.
--use-latest-agent-version|--no-use-latest-agent-version-
Spécifie s'il faut épingler l'image à la version de l'agent AppStream 2.0 actuellement installée ou s'il faut toujours utiliser la dernière version de l'agent. Si vous ne spécifiez aucun paramètre, l'image est épinglée à la version de l'agent AppStream 2.0 actuellement installée. Pour de plus amples informations, veuillez consulter Gérer les versions de l'agent AppStream 2.0.
--tags(chaîne)-
Balises à associer à l'image. Une balise est une paire clé-valeur. Utilisez le format suivant :
--tags "mykey" "myval" "mykey2" "myval2"
Pour en savoir plus sur les identifications, consultez Marquer vos ressources Amazon AppStream 2.0.
--dry-run(chaîne)-
Effectue une validation sans créer l'image. Utilisez cette commande pour vérifier si votre image contient des problèmes avant de la créer.
Sortie de message
| Code de sortie | Message imprimé sur la sortie standard | Description |
|---|---|---|
| 0 | {"status": 0, "message": "Success"} | Le flux de travail utilisé pour créer l'image a été lancé avec succès. |
| 1 | {"status": 1, "message": "Administrator privileges are required to perform this operation"} | Les privilèges d’administrateur sont nécessaires pour effectuer l’opération. |
| 1 | {"status": 1, "message": "An image with the given name already exists"} | Une image du même nom existe déjà dans le compte Amazon Web Services. |
| 1 | {"status": 1, "message": "Invalid value (balises)"} | Les balises spécifiées ne sont pas valides. |
| 255 | {"status": 255, "message": <message_erreur>} | Une erreur inattendue s’est produite. Répétez la demande. Si l'erreur persiste, contactez AWS Support pour obtenir de l'aide. Pour plus d’informations, consultez le Centre AWS Support |
