

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar `DeregisterImage` com uma CLI
<a name="example_ec2_DeregisterImage_section"></a>

Os exemplos de código a seguir mostram como usar o `DeregisterImage`.

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

**AWS CLI**  
**Cancelar o registro de uma AMI**  
Este exemplo cancela o registro da AMI especificada. Se o comando for bem-sucedido, nenhuma saída será retornada.  
Comando:  

```
aws ec2 deregister-image --image-id ami-4fa54026
```
+  Para obter detalhes da API, consulte [DeregisterImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/deregister-image.html)em *Referência de AWS CLI Comandos*. 

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

**Ferramentas para PowerShell V4**  
**Exemplo 1: esse exemplo cancela o registro da AMI especificada.**  

```
Unregister-EC2Image -ImageId ami-12345678
```
+  Para obter detalhes da API, consulte [DeregisterImage](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. 

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse exemplo cancela o registro da AMI especificada.**  

```
Unregister-EC2Image -ImageId ami-12345678
```
+  Para obter detalhes da API, consulte [DeregisterImage](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------

Para obter uma lista completa dos guias do desenvolvedor do AWS SDK e exemplos de código, consulte[Crie recursos do Amazon EC2 usando um AWS SDK](sdk-general-information-section.md). Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.