

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

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

# O que é o Ferramentas da AWS para PowerShell?
<a name="pstools-welcome"></a>

 Ferramentas da AWS para PowerShell São um conjunto de PowerShell módulos baseados na funcionalidade exposta pelo AWS SDK para .NET. Eles Ferramentas da AWS para PowerShell permitem que você crie scripts de operações em seus AWS recursos a partir da linha de PowerShell comando.

Os cmdlets fornecem uma PowerShell experiência idiomática para especificar parâmetros e lidar com resultados, mesmo que sejam implementados usando a consulta HTTP de vários serviços. AWS APIs Por exemplo, os cmdlets do PowerShell pipeline de Ferramentas da AWS para PowerShell suporte, ou seja, você pode canalizar PowerShell objetos para dentro e para fora dos cmdlets.

Eles Ferramentas da AWS para PowerShell são flexíveis na forma como permitem que você gerencie as credenciais, incluindo suporte para a infraestrutura AWS Identity and Access Management (IAM). É possível usar as ferramentas com credenciais de usuário do IAM, tokens de segurança temporários e funções do IAM.

Eles Ferramentas da AWS para PowerShell oferecem suporte ao mesmo conjunto de serviços e AWS regiões compatíveis com o SDK. Você pode instalar o Ferramentas da AWS para PowerShell em computadores que executam sistemas operacionais Windows, Linux ou macOS.

Eles Ferramentas da AWS para PowerShell estão disponíveis como os três pacotes distintos a seguir:
+ [`AWS.Tools`](#pwsh_structure_pstools)
+ [AWSPowerConcha. NetCore](#pwsh_structure_pscore)
+ [AWSPowerConcha](#pwsh_structure_psoldwin)

## Manutenção e suporte para as versões principais do SDK
<a name="sdks-major-versions-maintenance-support"></a>

Para obter informações sobre manutenção e suporte para as versões principais do SDK e suas dependências subjacentes, consulte o seguinte no Guia de [referência de ferramentas AWS SDKs e ferramentas:](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html)
+ [AWS SDKs e política de manutenção de ferramentas](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html)
+ [AWS SDKs matriz de suporte de versões e ferramentas](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html)

## `AWS.Tools`- Uma versão modularizada do Ferramentas da AWS para PowerShell
<a name="pwsh_structure_pstools"></a>

 [https://www.powershellgallery.com/packages/AWS.Tools.Installer](https://www.powershellgallery.com/packages/AWS.Tools.Installer) [https://www.powershellgallery.com/packages/AWS.Tools.Common](https://www.powershellgallery.com/packages/AWS.Tools.Common) [https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)

Essa versão do Ferramentas da AWS para PowerShell é a versão recomendada para qualquer computador executado PowerShell em um ambiente de produção. Como ele é modularizado, é necessário fazer download e carregar somente os módulos dos serviços que deseja usar. Isso reduz o tempo de download, o uso de memória e, na maioria dos casos, habilita a importação automática de cmdlets das `AWS.Tools` sem a necessidade de chamar `Import-Module` manualmente primeiro.

Essa é a versão mais recente Ferramentas da AWS para PowerShell e é executada em todos os sistemas operacionais compatíveis, incluindo Windows, Linux e macOS. Esse pacote fornece um módulo de instalação`AWS.Tools.Installer`, um módulo comum e um módulo para cada AWS serviço, por exemplo,`AWS.Tools.EC2`, `AWS.Tools.IdentityManagement``AWS.Tools.S3`, e assim por diante. `AWS.Tools.Common`

O `AWS.Tools.Installer` módulo fornece cmdlets que permitem instalar, atualizar e remover os módulos de cada um dos AWS serviços. Os cmdlets desse módulo garantem automaticamente que você tenha todos os módulos dependentes necessários para oferecer suporte aos módulos que você deseja usar.

O módulo `AWS.Tools.Common` fornece cmdlets para configuração e autenticação que não são específicos do produto. Para usar os cmdlets para um AWS serviço, basta executar o comando. PowerShellimporta automaticamente o `AWS.Tools.Common` módulo e o módulo do AWS serviço cujo cmdlet você deseja executar. Esse módulo é instalado automaticamente se você usar o módulo `AWS.Tools.Installer` para instalar os módulos do serviço.

Você pode instalar essa versão do Ferramentas da AWS para PowerShell em computadores que estão executando:
+ PowerShell Core 6.0 ou posterior no Windows, Linux ou macOS.
+ Windows PowerShell 5.1 ou posterior no Windows com o.NET Framework 4.7.2 ou posterior.

Ao longo deste guia, quando precisamos especificar somente esta versão, nos referimos a ela pelo nome do módulo: *`AWS.Tools`*.

Neste guia, você pode encontrar detalhes sobre a instalação `AWS.Tools` no [Windows](ps-installing-awstools.md), [Linux ou macOS](install-aws.tools-on-linux-macos.md).

## AWSPowerConcha. NetCore - Uma versão de módulo único do Ferramentas da AWS para PowerShell
<a name="pwsh_structure_pscore"></a>

[https://www.powershellgallery.com/packages/AWSPowerShell.NetCore/](https://www.powershellgallery.com/packages/AWSPowerShell.NetCore/) [https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip)

Essa versão consiste em um único módulo grande que contém suporte para todos os AWS serviços. Antes de usar este módulo, você deverá importá-lo manualmente.

Você pode instalar essa versão do Ferramentas da AWS para PowerShell em computadores que estão executando:
+ PowerShell Core 6.0 ou posterior no Windows, Linux ou macOS.
+ Windows PowerShell 3.0 ou posterior no Windows com o.NET Framework 4.7.2 ou posterior.

Ao longo deste guia, quando precisamos especificar somente essa versão, nos referimos a ela pelo nome do módulo: *AWSPowerShell. NetCore*.

Neste guia, você pode encontrar detalhes sobre a instalação do AWSPower Shell. NetCore no [Windows](ps-installing-awspowershellnetcore.md) e [Linux ou macOS](install-netcore-on-linux-macos.md).

## AWSPowerShell - Uma versão de módulo único para Windows PowerShell
<a name="pwsh_structure_psoldwin"></a>

[https://www.powershellgallery.com/packages/AWSPowerShell/](https://www.powershellgallery.com/packages/AWSPowerShell/) [https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.zip)

Essa versão *antiga* do só Ferramentas da AWS para PowerShell é compatível e pode ser instalada em computadores Windows que estejam executando as PowerShell versões 2.0 a 5.1 do Windows. Não é compatível com o PowerShell Core 6.0 ou posterior, nem com qualquer outro sistema operacional (Linux ou macOS). Essa versão consiste em um único módulo grande que contém suporte para todos os AWS serviços.

Ao longo deste guia, quando precisamos especificar somente essa versão, nos referimos a ela pelo nome do módulo: *AWSPowerShell*.

Neste guia, você pode encontrar detalhes sobre a instalação do AWSPower Shell no [Windows](ps-installing-awswindowspowershell.md).

## Como usar este guia
<a name="how-to-use-this-guide"></a>

O guia é dividido nas seções principais a seguir.

** [Comece com o Ferramentas da AWS para PowerShell](pstools-getting-set-up.md) **  
Esta seção explica como instalar Ferramentas da AWS para PowerShell e especificar as credenciais.

** [Configurando e usando o Ferramentas da AWS para PowerShell](pstools-getting-started.md) **  
Esta seção descreve os fundamentos do uso do Ferramentas da AWS para PowerShell, como especificar AWS regiões, encontrar cmdlets para um serviço específico e usar aliases para cmdlets.

** [AWS Serviços de chamadas no Ferramentas da AWS para PowerShell](pstools-using.md) **  
Esta seção inclui informações sobre como usar o Ferramentas da AWS para PowerShell para realizar algumas das AWS tarefas mais comuns.

## Tópicos adicionais nesta seção
<a name="w2aab7c27"></a>
+ [Histórico de revisões](revision-history.md)
+ [O que há de novo no Ferramentas da AWS para PowerShell](whats-new.md)

# Histórico de revisões
<a name="revision-history"></a>

Para descobrir o que mudou em várias versões, veja o seguinte:
+ [Os registros de alterações](https://github.com/aws/aws-tools-for-powershell/tree/main/changelogs)
+ [O que há de novo no Ferramentas da AWS para PowerShell](whats-new.md)
+ [Histórico do documento](history-pst.md)

# O que há de novo no Ferramentas da AWS para PowerShell
<a name="whats-new"></a>

Para obter informações de alto nível sobre novos desenvolvimentos relacionados ao Ferramentas da AWS para PowerShell, consulte a página do produto em [https://aws.amazon.com/powershell/](https://aws.amazon.com/powershell/)e os [registros de alterações](https://github.com/aws/aws-tools-for-powershell/tree/main/changelogs).

Veja a seguir o que há de novo nas Ferramentas para PowerShell.

**17 de setembro de 2025: disponível end-of-support para a versão 4 do Ferramentas da AWS para PowerShell**

A end-of-support versão 4 do Ferramentas da AWS para PowerShell foi anunciada. Consulte o [guia de migração](migrating-v5.md) para migrar seus scripts V4 e evitar interrupções. Para obter mais informações, consulte a postagem do blog [Anunciando o end-of-support for Ferramentas da AWS para PowerShell v4](https://aws.amazon.com/blogs/devops/announcing-the-end-of-support-for-aws-tools-for-powershell-v4/).

**23 de junho de 2025: Versão 5 do Ferramentas da AWS para PowerShell**

A versão 5 (V5) do Ferramentas da AWS para PowerShell está disponível ao público em geral\$1 Para obter informações sobre como migrar seus aplicativos para a V5, consulte. [Migrando para a V5](migrating-v5.md) Veja também a postagem do blog [Ferramentas da AWS para PowerShell V5 agora disponível ao público em geral](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v5-now-generally-available/).

**10 de fevereiro de 2025: versão GA para observabilidade**

Observabilidade é até que ponto o estado atual de um sistema pode ser inferido a partir dos dados que ele emite. A observabilidade foi adicionada às Ferramentas para PowerShell, incluindo a implementação de um provedor de telemetria. Para obter mais informações, consulte [Observabilidade](observability.md) este guia e a postagem do blog [Anunciando a disponibilidade geral das AWS OpenTelemetry bibliotecas.NET](https://aws.amazon.com/blogs/dotnet/announcing-the-general-availability-of-aws-net-opentelemetry-libraries/).

**15 de janeiro de 2025: novo comportamento padrão para proteção de integridade**

A partir da versão 4.1.737 do Ferramentas da AWS para PowerShell, as ferramentas fornecem proteções de integridade padrão calculando automaticamente uma soma de verificação para uploads. `CRC32` Para obter mais informações, consulte o anúncio GitHub em[https://github.com/aws/aws-tools-for-powershell/issues/370](https://github.com/aws/aws-tools-for-powershell/issues/370). As ferramentas também fornecem configurações globais para proteções de integridade de dados que você pode definir externamente, sobre as quais você pode ler em [Proteções de integridade de dados](https://docs.aws.amazon.com/sdkref/latest/guide/feature-dataintegrity.html) no Guia de referência de [ferramentas AWS SDKs e ferramentas](https://docs.aws.amazon.com/sdkref/latest/guide/).

**18 de novembro de 2024: versão prévia 1 para a versão 5**

A prévia 1 da Ferramentas da AWS para PowerShell versão 5 foi lançada em 18 de novembro de 2024. Para obter mais informações sobre essa prévia, consulte a postagem do blog [Prévia 1 da Ferramentas da AWS para PowerShell V5](https://aws.amazon.com/blogs/developer/preview-1-of-aws-tools-for-powershell-v5/).