O que é o Ferramentas da AWS para PowerShell? - Ferramentas da AWS para PowerShell (versão 4)

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

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

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?

O Ferramentas da AWS para PowerShell é um conjunto de módulos do PowerShell criados com base na funcionalidade exposta pelo AWS SDK para .NET. O Ferramentas da AWS para PowerShell permite que você faça script de operações em seus recursos da AWS a partir da linha de comando do PowerShell.

Os cmdlets fornecem uma experiência idiomática do PowerShell para especificar parâmetros e lidar com os resultados, mesmo que eles sejam implementados usando as várias APIs de consulta HTTP do produto da AWS. Por exemplo, os cmdlets para o Ferramentas da AWS para PowerShell oferecem suporte ao pipeline do PowerShell ou seja, você pode estruturar objetos do PowerShell nos cmdlets e fora deles.

O Ferramentas da AWS para PowerShell é flexível na forma como permite a você manipular credenciais, incluindo suporte à infraestrutura do 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.

O Ferramentas da AWS para PowerShell oferece suporte ao mesmo conjunto de serviços e regiões da AWS compatíveis com o SDK. É possível instalar o Ferramentas da AWS para PowerShell em computadores com sistemas operacionais Windows, Linux ou macOS.

nota

O Ferramentas da AWS para PowerShell versão 4 (V4) é uma atualização compatível com versões anteriores ao Ferramentas da AWS para PowerShell versão 3.3. Ele adiciona melhorias significativas enquanto mantém o comportamento existente do cmdlet. Os scripts existentes deverão continuar funcionando depois do upgrade para o V4, mas é recomendável testá-los atentamente antes do upgrade. Para obter mais informações sobre essas alterações no V4, consulte Migrar do Ferramentas da AWS para PowerShell versão 3.3 para a versão 4.

O Ferramentas da AWS para PowerShell está disponível como os três pacotes distintos a seguir:

Manutenção e suporte para as versões principais de SDK

Para obter informações sobre manutenção e suporte para versões principais do SDK e suas dependências subjacentes, consulte o seguinte no Guia de referência de AWS SDKs e ferramentas:

AWS.Tools - uma versão modularizada do Ferramentas da AWS para PowerShell

PowerShell Gallery AWS.Tools.Installer module icon. PowerShell Gallery module icon for AWS.Tools.Common. Icon representing ZIP Archive AWS Tools, showing a folder with AWS logo.

Esta versão do Ferramentas da AWS para PowerShell é a versão recomendada para qualquer computador executando o 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.

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

O módulo AWS.Tools.Installer fornece cmdlets que permitem instalar, atualizar e remover os módulos para cada um dos serviços da AWS. 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 produto da AWS, basta executar o comando. O PowerShell importa automaticamente o módulo AWS.Tools.Common e o módulo para o produto da AWS 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.

É possível instalar esta versão do Ferramentas da AWS para PowerShell em computadores que estejam 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.

AWSPowerShell.NetCore: uma versão de módulo único do Ferramentas da AWS para PowerShell

PowerShell Gallery and AWSPowerShell.NetCore module icons. Icon representing a ZIP archive file labeled "AWSPowerShell.NetCore".

Ela consiste em um único módulo grande que contém suporte a todos os produtos da AWS. Antes de usar este módulo, você deverá importá-lo manualmente.

É possível instalar esta versão do Ferramentas da AWS para PowerShell em computadores que estejam 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, sempre que precisarmos especificar somente esta versão, faremos referência a ela pelo nome do módulo: AWSPowerShell.NetCore.

AWSPowerShell: uma versão de módulo único para o Windows PowerShell

PowerShell Gallery and AWSPowerShell module icons displayed side by side. Icon representing ZIP Archive with "AWSPowerShell" text label.

Esta versão do Ferramentas da AWS para PowerShell é compatível com e pode ser instalada somente em computadores Windows que executam as versões 2.0 a 5.1 do Windows PowerShell. Ela não é compatível com o PowerShell Core 6.0 ou posterior, ou qualquer outro sistema operacional (Linux ou macOS). Ela consiste em um único módulo grande que contém suporte a todos os produtos da AWS.

Ao longo deste guia, sempre que precisarmos especificar somente esta versão, faremos referência a ela pelo nome do módulo: AWSPowerShell.

Como usar este guia

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

Instalar o Ferramentas da AWS para PowerShell

Esta seção explica como instalar o Ferramentas da AWS para PowerShell. Ele inclui informações sobre como se cadastrar na AWS se você ainda não tiver uma conta e como criar um usuário do IAM que pode ser usado para executar os cmdlets.

Conceitos básicos da  AWS Tools for Windows PowerShell

Esta seção descreve os conceitos básicos do uso do Ferramentas da AWS para PowerShell, como especificar credenciais e regiões da AWS, encontrar cmdlets para um determinado produto e o uso de aliases para cmdlets.

Trabalhar com serviços da AWS no Ferramentas da AWS para PowerShell

Esta seção inclui informações sobre como usar o Ferramentas da AWS para PowerShell para executar algumas das tarefas mais comuns da AWS.

Tópicos adicionais nesta seção