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.

# Créez votre image Amazon WorkSpaces Applications par programmation à l'aide des opérations de la CLI de l'Assistant Image
<a name="programmatically-create-image"></a>

Vous pouvez créer des images Amazon WorkSpaces Applications en vous connectant à un générateur d'images et en utilisant les opérations de l'interface utilisateur graphique (GUI) ou de l'interface de ligne de commande (CLI) d'Image Assistant. Les opérations d'interface de ligne de commande Image Assistant fournissent des fonctionnalités similaires à l’interface utilisateur graphique d’Image Assistant. Avec ces opérations, vous pouvez effectuer les actions suivantes par programmation :
+ Gérer les applications incluses dans une image.
+ Enregistrer, mettre à jour et réinitialiser les paramètres par défaut d’une application.
+ Activez ou désactivez le framework WorkSpaces d'applications dynamiques des applications.
+ Spécifier des balises.
+ Créer une image.

 Vous pouvez utiliser ces opérations pour intégrer la création d'images d' WorkSpaces applications à votre processus de développement logiciel d'intégration continue ou de déploiement.

Pour utiliser les opérations d’interface de ligne de commande d’Image Assistant, utilisez le shell de ligne de commande de votre choix sur un Image Builder. Par exemple, vous pouvez utiliser l'invite de commande Windows ou PowerShell.

**Note**  
Le générateur d'images doit utiliser une version de l'agent WorkSpaces Applications publiée le 26 juillet 2019 ou après cette date. Si vous ne disposez pas d’une instance Image Builder, vous devez en créer une. Pour plus d’informations, consultez [Lancer un Image Builder pour l'installation et la configuration d'applications de streaming](tutorial-image-builder-create.md).

**Topics**
+ [

# Création des paramètres d’application et Windows par défaut avec les opérations d'interface de ligne de commande d’Image Assisant
](create-default-app-windows-settings-image-assistant.md)
+ [

# Optimisation des performances de lancement de vos applications avec les opérations d’interface de ligne de commande d’Image Assistant
](optimize-app-launch-performance-image-assistant-cli.md)
+ [

# Présentation du processus de création programmatique d'une image Amazon Applications WorkSpaces
](process-overview-creating-image-programmatically-image-assistant-cli.md)
+ [

# Opérations de la CLI Image Assistant pour créer et gérer votre image d' WorkSpaces applications Amazon
](cli-operations-managing-creating-image-image-assistant.md)

# Création des paramètres d’application et Windows par défaut avec les opérations d'interface de ligne de commande d’Image Assisant
<a name="create-default-app-windows-settings-image-assistant"></a>

Vous pouvez créer des paramètres d'application et Windows par défaut afin que vos utilisateurs puissent démarrer rapidement avec leurs applications. Lorsque vous créez ces paramètres, WorkSpaces Applications remplace le profil utilisateur par défaut de Windows par le profil que vous configurez. Le profil utilisateur Windows par défaut est ensuite utilisé pour créer les paramètres initiaux pour les utilisateurs dans l’instance de flotte. Si vous créez ces paramètres à l'aide des opérations d’interface de ligne de commande Image Assistant, votre programme d'installation de l'application, ou l'automatisation, doit modifier le profil d’utilisateur Windows par défaut directement.

Pour remplacer le profil d’utilisateur Windows par défaut par celui d’un autre utilisateur Windows, vous pouvez également utiliser l'opération d’interface de ligne de commande `update-default-profile` d’Image Assistant.

Pour plus d'informations sur la configuration des applications par défaut et des paramètres Windows, voir *Création de paramètres d'application et Windows par défaut pour les utilisateurs de vos WorkSpaces applications* dans[Paramètres par défaut des applications et de Windows et performances de lancement des applications dans Amazon WorkSpaces Applications](customizing-appstream-images.md).

# Optimisation des performances de lancement de vos applications avec les opérations d’interface de ligne de commande d’Image Assistant
<a name="optimize-app-launch-performance-image-assistant-cli"></a>

WorkSpaces Les applications vous permettent d'optimiser les performances de lancement de vos applications pour les sessions de streaming de vos utilisateurs. Lorsque vous utilisez pour ce faire des opérations d’interface de ligne de commande d’Image Assistant, vous pouvez spécifier les fichiers à optimiser pour le lancement de votre application. L’ajout de fichiers au manifeste d’optimisation d’application réduit le temps nécessaire au lancement initial d’une application sur une nouvelle instance de flotte. Toutefois, cela augmente également le temps nécessaire pour que les instances de flotte soient mises à la disposition des utilisateurs. Le manifeste d'optimisation est un fichier texte délimité par des lignes spécifique à l’application. 

**Note**  
Si vous intégrez des manifestes d’optimisation d'application en utilisant à la fois des opérations d’interface de ligne de commande d’Image Assistant et l’interface utilisateur graphique d’Image Assistant, les manifestes sont fusionnés.

Voici un exemple de fichier manifeste d’optimisation des applications :

```
C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml
```

Pour plus d'informations sur l'optimisation des performances de lancement de vos applications, consultez *Optimisation des performances de lancement de vos applications* dans [Paramètres par défaut des applications et de Windows et performances de lancement des applications dans Amazon WorkSpaces Applications](customizing-appstream-images.md).

# Présentation du processus de création programmatique d'une image Amazon Applications WorkSpaces
<a name="process-overview-creating-image-programmatically-image-assistant-cli"></a>

Vous pouvez utiliser les opérations de la CLI Image Assistant avec l'automatisation de l'installation de vos applications pour créer un flux de travail de création d'images d' WorkSpaces applications entièrement programmatique. Une fois votre demande d'automatisation d'installation terminée, mais avant la création de l'image, utilisez les opérations d'interface de ligne de commande d’Image Assistant pour spécifier les éléments suivants :
+ Les fichiers exécutables que vos utilisateurs peuvent lancer
+ Les manifestes d’optimisation pour vos applications
+ Métadonnées d'image WorkSpaces pour les autres applications

La présentation générale suivante décrit le processus de création par programmation d'une image d' WorkSpaces applications.

1. Utilisez l’automatisation d’installation de votre application pour installer les applications requises sur votre mage Builder. Cette installation peut inclure des applications que vos utilisateurs lanceront, des dépendances, et des applications en arrière-plan.

1. Déterminez les fichiers et les dossiers à optimiser.

1. Le cas échéant, utilisez l'opération Image Assistant `add-application` CLI pour spécifier les métadonnées de l'application et le manifeste d'optimisation pour l'image WorkSpaces Applications.

1. Pour spécifier des applications supplémentaires pour l'image WorkSpaces Applications, répétez les étapes 1 à 3 pour chaque application selon les besoins.

1. Le cas échéant, utilisez l'opération d’interface de ligne de commande `update-default-profile` d’Image Assistant pour remplacer le profil Windows par défaut et créer les paramètres d’application et Windows par défaut pour vos utilisateurs.

1. Utilisez l'opération d’interface de ligne de commande `create-image` d’Image Assistant pour créer l'image.

# Opérations de la CLI Image Assistant pour créer et gérer votre image d' WorkSpaces applications Amazon
<a name="cli-operations-managing-creating-image-image-assistant"></a>

Cette section décrit les opérations de la CLI Image Assistant que vous pouvez utiliser pour créer et gérer votre image d' WorkSpaces applications.

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:\$1Program Files \$1 Amazon \$1 Photon \$1 ConsoleImageBuilder \$1 Image-Assistant.exe. Pour plus de commodité, ce fichier exécutable est inclus dans la variable Windows PATH. Cela vous permet d'appeler les opérations d'interface de ligne de commande d’Image Assistant sans spécifier le chemin absolu vers le fichier exécutable. Pour appeler ces opérations, tapez la commande **image-assistant.exe**.

Sur les générateurs d'images Linux, l'outil d'assistant d'image se trouve à l'adresse/usr/local/appstream/image-assistant/AppStreamImageAssistant, with a symbolic link at /bin/AppStreamImageAssistant.

## Opération `help`
<a name="help-operation-image-assistant-cli"></a>

Extrait une liste de toutes les opérations d'interface de ligne de commande 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`
<a name="add-application-operation-image-assistant-cli"></a>

Ajoute l'application à la liste des WorkSpaces applications pour les utilisateurs des applications. 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 d' WorkSpaces applications.

**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, WorkSpaces Applications 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 WorkSpaces Applications 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 |  \$1"status": 0, "message": "Success"\$1  |  L'application a été ajoutée avec succès.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  Les privilèges d’administrateur sont nécessaires pour effectuer l’opération.  | 
| 1 |  \$1"status": 1, "message": "Unable to add more than 50 apps to the catalog."\$1  |  L'application n'a pas pu être ajoutée car le nombre maximum d'applications pouvant être ajoutées au catalogue d' WorkSpaces applications est de 50.  | 
| 1 |  \$1"status": 1, "message": "Name is not unique"\$1  |  Une application portant ce nom existe déjà dans le catalogue d' WorkSpaces applications Applications.  | 
| 1 |  \$1"status » : 1, « message » : « Fichier introuvable (absolute-app-path)"\$1  |  Le fichier spécifié pour absolute-app-path est introuvable.  | 
| 1 |  \$1"status": 1, "message": "Unsupported file extension"\$1  |  Le paramètre Absolute-app-path prend uniquement en charge les types de fichiers suivants : .exe et .bat.  | 
| 1 |  \$1"status": 1, "message": "Directory not found (répertoire\$1travail)"  |  Le répertoire spécifié pour working-directory est introuvable.  | 
| 1 |  \$1"status": 1, "message": "Optimization-manifest not found: <nom\$1fichier>"\$1  |  Le fichier spécifié pour optimization-manifest est introuvable.  | 
| 1 |  \$1"status": 1, "message": "File not found: <nom\$1fichier>"\$1  |  Un fichier spécifié dans le manifeste d'optimisation est introuvable.  | 
| 255 |  \$1"status": 255, "message": <message\$1erreur>\$1  |  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](https://console.aws.amazon.com/support/home#/).  | 

## Opération `remove-application`
<a name="remove-application-operation-image-assistant-cli"></a>

Supprime une application de la liste des applications pour l'image WorkSpaces Applications. L'application n'est ni désinstallée ni modifiée, mais les utilisateurs ne pourront pas la lancer depuis le catalogue d' WorkSpaces applications Applications.

**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 |  \$1"status": 0, "message": "Success"\$1  |  L'application a été supprimée avec succès.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  Les privilèges d’administrateur sont nécessaires pour effectuer l’opération.  | 
| 1 |  \$1"status": 1, "message": "App not found"\$1  |  L'application spécifiée est introuvable dans le catalogue d' WorkSpaces applications Applications.  | 
| 255 |  \$1"status": 255, "message": <message\$1erreur>\$1  |  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](https://console.aws.amazon.com/support/home#/).  | 

## Opération `list-applications`
<a name="list-applications-operation-image-assistant-cli"></a>

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 |  \$1"status": 0, "message": "Success", "applications": [ \$1..app1.. \$1, \$1 ..app2.. \$1]\$1  |  Liste des applications du catalogue WorkSpaces d'applications Applications.  | 
| 255 |  \$1"status": 255, "message": <message\$1erreur>\$1  |  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](https://console.aws.amazon.com/support/home#/).  | 

## Opération `update-default-profile`
<a name="update-default-profile-image-assistant-cli"></a>

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’outil de CLI Image Assistant 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>\$1<nom\$1utilisateur>"  
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 d' WorkSpaces applications est utilisé.

**Sortie de message**


| Code de sortie | Message imprimé sur la sortie standard | Description | 
| --- | --- | --- | 
| 0 |  \$1"status": 0, "message": "Success"\$1  |  Les paramètres utilisateur ont été copiés dans le profil Windows par défaut.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  Les privilèges d’administrateur sont nécessaires pour effectuer l’opération.  | 
| 1 |  \$1"status": 1, "message": "Unable to copy file or folder: <chemin>. <raison>"\$1  |  Les paramètres utilisateur n'ont pas pu être copiés, car un fichier ou un dossier était indisponible.  | 
| 1 |  \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1  |  Un utilisateur du domaine Microsoft Active Directory a été spécifié, mais l’instance Image Builder n’est jointe à aucun domaine Active Directory.  | 
| 255 |  \$1"status": 255, "message": <message\$1erreur>\$1  |  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](https://console.aws.amazon.com/support/home#/).  | 

## Opération `reset-user-profile`
<a name="reset-user-profile-image-assistant-cli"></a>

Supprime le profil utilisateur Windows pour l'utilisateur spécifié.

**Note**  
Cette opération n’est pas prise en charge par l’outil de CLI Image Assistant 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>\$1<nom\$1utilisateur>"  
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 |  \$1"status": 0, "message": "Success"\$1  |  Les paramètres de l'utilisateur spécifié ont été supprimés avec succès.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  Les privilèges d’administrateur sont nécessaires pour effectuer l’opération.  | 
| 1 |  \$1"status": 1, "message": "Unable to copy file or folder: <chemin>. <raison>"\$1  |  Les paramètres de l'utilisateur n'a pas pu être réinitialisés, car un fichier ou un dossier était indisponible.  | 
| 1 |  \$1"status": 1, "message": "Cannot copy a domain user when not joined to a domain""\$1  |  Un utilisateur du domaine Microsoft Active Directory a été spécifié, mais l’instance Image Builder n’est jointe à aucun domaine Active Directory.  | 
| 255 |  \$1"status": 255, "message": <message\$1erreur>\$1  |  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](https://console.aws.amazon.com/support/home#/).  | 

## Opération `create-image`
<a name="create-image-operation-image-assistant-cli"></a>

Lance le flux de travail de création d'image, qui produit une image d' WorkSpaces applications qui peut être utilisée pour les flottes WorkSpaces d'applications.

**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 WorkSpaces Applications. 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 (\$1), 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` \$1 `--no-enable-dynamic-app-catalog`**  
Active ou désactive la prise en charge de l'infrastructure WorkSpaces d'applications dynamiques des applications. 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 d' WorkSpaces applications 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' WorkSpaces applications dynamiques pour créer un fournisseur d'applications dynamiques](build-dynamic-app-provider.md).

**`--use-latest-agent-version` \$1 `--no-use-latest-agent-version`**  
Spécifie s'il faut épingler l'image à la version de l'agent WorkSpaces Applications 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 WorkSpaces Applications actuellement installée. Pour de plus amples informations, veuillez consulter [Gérer les versions WorkSpaces des agents d'applications](base-images-agent.md).

**`--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 les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).

**`--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 |  \$1"status": 0, "message": "Success"\$1  |  Le flux de travail utilisé pour créer l'image a été lancé avec succès.  | 
| 1 |  \$1"status": 1, "message": "Administrator privileges are required to perform this operation"\$1  |  Les privilèges d’administrateur sont nécessaires pour effectuer l’opération.  | 
| 1 |  \$1"status": 1, "message": "An image with the given name already exists"\$1  |  Une image du même nom existe déjà dans le compte Amazon Web Services.  | 
| 1 |  \$1"status": 1, "message": "Invalid value (balises)"\$1  |  Les balises spécifiées ne sont pas valides.  | 
| 255 |  \$1"status": 255, "message": <message\$1erreur>\$1  |  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](https://console.aws.amazon.com/support/home#/).  |