

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Utilizar `ModifyImageAttribute` con una CLI
<a name="example_ec2_ModifyImageAttribute_section"></a>

Los siguientes ejemplos de código muestran cómo utilizar `ModifyImageAttribute`.

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

**AWS CLI**  
**Ejemplo 1: operación de hacer pública una AMI**  
En el siguiente ejemplo de `modify-instance-attribute` se hace pública la AMI especificada.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{Group=all}]"
```
Este comando no genera ninguna salida.  
**Ejemplo 2: operación de hacer privada una AMI**  
En el siguiente ejemplo de `modify-instance-attribute` se hace privada la AMI especificada.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{Group=all}]"
```
Este comando no genera ninguna salida.  
**Ejemplo 3: Para conceder el permiso de lanzamiento a una AWS cuenta**  
En el siguiente `modify-instance-attribute` ejemplo, se conceden permisos de lanzamiento a la AWS cuenta especificada.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{UserId=123456789012}]"
```
Este comando no genera ninguna salida.  
**Ejemplo 4: Para eliminar el permiso de lanzamiento de una AWS cuenta**  
En el siguiente `modify-instance-attribute` ejemplo, se eliminan los permisos de lanzamiento de la AWS cuenta especificada.  

```
aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{UserId=123456789012}]"
```
+  Para obtener más información sobre la API, consulte [ModifyImageAttribute](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/modify-image-attribute.html)la *Referencia de AWS CLI comandos*. 

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

**Herramientas para la PowerShell versión 4**  
**Ejemplo 1: En este ejemplo se actualiza la descripción de la AMI especificada.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"
```
**Ejemplo 2: Este ejemplo hace pública la AMI (por ejemplo, para que cualquiera Cuenta de AWS pueda usarla).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all
```
**Ejemplo 3: En este ejemplo se hace privada la AMI (por ejemplo, para que solo usted, como propietario, pueda utilizarla).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all
```
**Ejemplo 4: en este ejemplo se concede el permiso de lanzamiento a la persona especificada Cuenta de AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333
```
**Ejemplo 5: Este ejemplo elimina el permiso de lanzamiento del especificado Cuenta de AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
```
+  Para obtener más información sobre la API, consulte [ModifyImageAttribute Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*. 

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: En este ejemplo se actualiza la descripción de la AMI especificada.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"
```
**Ejemplo 2: Este ejemplo hace pública la AMI (por ejemplo, para que cualquiera Cuenta de AWS pueda usarla).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all
```
**Ejemplo 3: En este ejemplo se hace privada la AMI (por ejemplo, para que solo usted, como propietario, pueda utilizarla).**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all
```
**Ejemplo 4: en este ejemplo se concede el permiso de lanzamiento a la persona especificada Cuenta de AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333
```
**Ejemplo 5: Este ejemplo elimina el permiso de lanzamiento del especificado Cuenta de AWS.**  

```
Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333
```
+  Para obtener más información sobre la API, consulte [ModifyImageAttribute Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*. 

------

Para obtener una lista completa de guías para desarrolladores del AWS SDK y ejemplos de código, consulte. [Creación de recursos de Amazon EC2 mediante una AWS SDK](sdk-general-information-section.md) En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.