A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\!

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).

 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)

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á.

# Encontre uma imagem de máquina da Amazon usando o Windows PowerShell
<a name="pstools-ec2-get-amis"></a>

Ao iniciar uma EC2 instância da Amazon, você especifica uma Amazon Machine Image (AMI) para servir como modelo para a instância. No entanto, o IDs para o AWS Windows AMIs muda com frequência porque AWS fornece as atualizações e aprimoramentos de segurança mais recentes. AMIs Você pode usar o [Get-EC2Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2Image.html)cmdlet para encontrar o Windows atual AMIs e obter seu. IDs

## Get-EC2Image
<a name="pstools-ec2-get-image"></a>

O `Get-EC2Image` cmdlet recupera uma lista do AMIs que você pode usar.

Use o `-Owner` parâmetro com o valor da matriz `amazon, self` para `Get-EC2Image` recuperar somente os AMIs pertencentes à Amazon ou a você. Nesse contexto, *você* se refere ao usuário cujas credenciais foram usadas para invocar o cmdlet.

```
PS > Get-EC2Image -Owner amazon, self
```

Você pode limitar os resultados usando o parâmetro `-Filter`. Para especificar o filtro, crie um objeto do tipo `Amazon.EC2.Model.Filter`. Por exemplo, use o filtro a seguir para exibir somente o Windows AMIs.

```
$platform_values = New-Object 'collections.generic.list[string]'
$platform_values.add("windows")
$filter_platform = New-Object Amazon.EC2.Model.Filter -Property @{Name = "platform"; Values = $platform_values}
Get-EC2Image -Owner amazon, self -Filter $filter_platform
```

Veja a seguir um exemplo de um dos AMIs retornados pelo cmdlet; a saída real do comando anterior fornece informações para muitos. AMIs

```
Architecture        : x86_64
BlockDeviceMappings : {/dev/sda1, xvdca, xvdcb, xvdcc…}
CreationDate        : 2019-06-12T10:41:31.000Z
Description         : Microsoft Windows Server 2019 Full Locale English with SQL Web 2017 AMI provided by Amazon
EnaSupport          : True
Hypervisor          : xen
ImageId             : ami-000226b77608d973b
ImageLocation       : amazon/Windows_Server-2019-English-Full-SQL_2017_Web-2019.06.12
ImageOwnerAlias     : amazon
ImageType           : machine
KernelId            : 
Name                : Windows_Server-2019-English-Full-SQL_2017_Web-2019.06.12
OwnerId             : 801119661308
Platform            : Windows
ProductCodes        : {}
Public              : True
RamdiskId           : 
RootDeviceName      : /dev/sda1
RootDeviceType      : ebs
SriovNetSupport     : simple
State               : available
StateReason         : 
Tags                : {}
VirtualizationType  : hvm
```

**nota**  
A versão 4 do Ferramentas da AWS para PowerShell forneceu o `Get-EC2ImageByName` cmdlet para filtrar a lista de padrões AMIs por nome. Para a versão 5 das ferramentas, use o cmdlet [Get- SSMLatest EC2 Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-SSMLatestEC2Image.html) em vez disso.