

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.

# Utilisation de `ModifyImageAttribute` avec une CLI
<a name="example_ec2_ModifyImageAttribute_section"></a>

Les exemples de code suivants illustrent comment utiliser `ModifyImageAttribute`.

------
#### [ CLI ]

**AWS CLI**  
**Exemple 1 : pour rendre une AMI publique**  
L’exemple `modify-instance-attribute` suivant rend l’AMI spécifiée publique.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{Group=all}]"
```
Cette commande ne produit aucune sortie.  
**Exemple 2 : pour rendre une AMI privée**  
L’exemple `modify-instance-attribute` suivant rend l’AMI spécifiée privée.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{Group=all}]"
```
Cette commande ne produit aucune sortie.  
**Exemple 3 : Pour accorder une autorisation de lancement à un AWS compte**  
L'`modify-instance-attribute`exemple suivant accorde des autorisations de lancement au AWS compte spécifié.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{UserId=123456789012}]"
```
Cette commande ne produit aucune sortie.  
**Exemple 4 : pour supprimer l'autorisation de lancement d'un AWS compte**  
L'`modify-instance-attribute`exemple suivant supprime les autorisations de lancement du AWS compte spécifié.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{UserId=123456789012}]"
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-image-attribute.html)à la section *Référence des AWS CLI commandes*. 

------
#### [ PowerShell ]

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple met à jour la description de l’AMI spécifiée.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"
```
**Exemple 2 : Cet exemple rend l'AMI publique (par exemple, afin que tout le Compte AWS monde puisse l'utiliser).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all
```
**Exemple 3 : cet exemple rend l’AMI privée (par exemple, afin que vous soyez le seul à pouvoir l’utiliser en tant que propriétaire).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all
```
**Exemple 4 : Cet exemple accorde l'autorisation de lancement à la personne spécifiée Compte AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333
```
**Exemple 5 : Cet exemple supprime l'autorisation de lancement spécifiée Compte AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyImageAttribute](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

**Outils pour PowerShell V5**  
**Exemple 1 : cet exemple met à jour la description de l’AMI spécifiée.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"
```
**Exemple 2 : Cet exemple rend l'AMI publique (par exemple, afin que tout le Compte AWS monde puisse l'utiliser).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all
```
**Exemple 3 : cet exemple rend l’AMI privée (par exemple, afin que vous soyez le seul à pouvoir l’utiliser en tant que propriétaire).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all
```
**Exemple 4 : Cet exemple accorde l'autorisation de lancement à la personne spécifiée Compte AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333
```
**Exemple 5 : Cet exemple supprime l'autorisation de lancement spécifiée Compte AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
```
+  Pour plus de détails sur l'API, reportez-vous [ModifyImageAttribute](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. 

------

Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Création de EC2 ressources Amazon à l'aide d'un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.