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

Instalar a Ferramentas da AWS para PowerShell no Windows

Um computador baseado no Windows pode executar uma das seguintes opções de pacote do Ferramentas da AWS para PowerShell:

O pacote escolhido depende da versão e edição do Windows sendo executado.

A configuração do Ferramentas da AWS para PowerShell envolve as tarefas de alto nível descritas em detalhes a seguir nesse tópico.

Pré-requisitos

As versões mais recentes do PowerShell, incluindo o PowerShell Core, estão disponíveis como downloads da Microsoft em Instalar várias versões do PowerShell no site da Microsoft.

Instalar o AWS.Tools no Windows

É possível instalar a versão modularizada do Ferramentas da AWS para PowerShell em computadores que executam o Windows com Windows PowerShell 5.1 ou PowerShell Core 6.0 ou posterior. Para obter informações sobre como instalar o PowerShell Core, consulte Instalar várias versões do PowerShell no site da Microsoft.

Você pode instalar o AWS.Tools de três maneiras:

Instalar o AWSPowerShell.NetCore no Windows

É possível instalar o AWSPowerShell.NetCore em computadores que executam o Windows com o PowerShell versão 3 a 5.1 ou PowerShell Core 6.0 ou posterior. Para obter informações sobre como instalar o PowerShell Core, consulte Instalar várias versões do PowerShell no site do Microsoft PowerShell.

É possível instalar o AWSPowerShell.NetCore de uma duas formas

Para instalar o AWSPowerShell.NetCore pela Galeria do PowerShell usando o cmdlet Install-Module

Para instalar o AWSPowerShell.NetCore a partir da Galeria do PowerShell, seu computador deve estar executando o PowerShell 5.0 ou posterior ou executando o PowerShellGet no PowerShell 3 ou posterior. Execute o comando a seguir.

PS > Install-Module -name AWSPowerShell.NetCore

Se você estiver executando o PowerShell como administrador, o comando anterior instalará o Ferramentas da AWS para PowerShell para todos os usuários no computador. Se você estiver executando o PowerShell como um usuário padrão sem permissões de administrador, esse mesmo comando instalará o Ferramentas da AWS para PowerShell apenas para o usuário atual.

Para instalar apenas para o usuário atual quando esse usuário tiver permissões de administrador, execute o comando com o conjunto de parâmetros do -Scope CurrentUser conforme indicado a seguir.

PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser

Embora o PowerShell 3.0 ou versões mais recentes normalmente carreguem módulos na sessão do PowerShell na primeira vez que você executa um cmdlet no módulo, o módulo AWSPowerShell.NetCore é muito grande para oferecer suporte a essa funcionalidade. Você deve carregar explicitamente o módulo AWSPowerShell.NetCore Core na sessão do PowerShell executando o comando a seguir.

PS > Import-Module AWSPowerShell.NetCore

Para carregar o módulo AWSPowerShell.NetCore na sessão do PowerShell automaticamente, adicione esse comando ao seu perfil do PowerShell. Para obter mais informações sobre como editar seu perfil do PowerShell, consulte About Profiles (Sobre perfis) na documentação do PowerShell.

Instalar o AWSPowerShell no Windows PowerShell

Você pode instalar o AWS Tools for Windows PowerShell de duas maneiras:

Para instalar o AWSPowerShell pela Galeria do PowerShell usando o cmdlet Install-Module

Você poderá instalar o AWSPowerShell a partir da Galeria do PowerShell se estiver executando o PowerShell 5.0 ou posterior ou tiver instalado o PowerShellGet no PowerShell 3 ou posterior. Você pode instalar e atualizar o AWSPowerShell a partir da Galeria do PowerShell da Microsoft executando o comando a seguir.

 PS > Install-Module -Name AWSPowerShell

Para carregar o módulo AWSPowerShell na sessão do PowerShell automaticamente, adicione o cmdlet import-module anterior em seu perfil do PowerShell. Para obter mais informações sobre como editar seu perfil do PowerShell, consulte About Profiles (Sobre perfis) na documentação do PowerShell.

Ativar a execução do script

Para carregar os módulos do Ferramentas da AWS para PowerShell, você deve habilitar a execução de script do PowerShell. Para habilitar a execução do script, execute o cmdlet Set-ExecutionPolicy para definir uma política de RemoteSigned. Para obter mais informações, consulte About Execution Policies no site da Microsoft Technet.

Para ativar a execução do script

Caso não tenha a política de execução definida corretamente, o PowerShell exibe o seguinte erro sempre que você tentar executar um script, assim como o seu perfil.

File C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 cannot be loaded because the execution
 of scripts is disabled on this system. Please see "get-help about_signing" for more details.
At line:1 char:2
+ . <<<<  'C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1'
    + CategoryInfo          : NotSpecified: (:) [], PSSecurityException
    + FullyQualifiedErrorId : RuntimeException

O instalador do Tools for Windows PowerShell atualiza automaticamente o valor de PSModulePath para incluir o local do diretório que contém o módulo AWSPowerShell.

Como o PSModulePath inclui o local do diretório do módulo da AWS, o cmdlet Get-Module -ListAvailable mostra o módulo.

PS > Get-Module -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   AppLocker                 {}
Manifest   BitsTransfer              {}
Manifest   PSDiagnostics             {}
Manifest   TroubleshootingPack       {}
Manifest   AWSPowerShell             {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...

Versionamento

A AWS lança novas versões do Ferramentas da AWS para PowerShell periodicamente para oferecer suporte a novos produtos e recursos da AWS. Para determinar a versão do Tools que você instalou, execute o cmdlet Get-AWSPowerShellVersion:

Por exemplo:

PS > Get-AWSPowerShellVersion

AWS Tools for PowerShell
Version 4.1.849
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NET
Core Runtime Version 3.7.402.75
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/v4.1/changelogs/CHANGELOG.ALL.md

This software includes third party software subject to the following copyrights:
- Logging from log4net, Apache License
[http://logging.apache.org/log4net/license.html]

Você também pode adicionar o parâmetro -ListServiceVersionInfo a um comando Get-AWSPowerShellVersion para ver uma lista dos serviços da AWS compatíveis com a versão atual das ferramentas. Se você usar a opção modularizada AWS.Tools.*, somente os módulos importados atualmente serão exibidos.

Por exemplo:

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
AWS IAM Access Analyzer            IAMAA       AWS.Tools.AccessAnalyzer          3.7.400.33
AWS Account                        ACCT        AWS.Tools.Account                 3.7.400.33
AWS Certificate Manager Private... PCA         AWS.Tools.ACMPCA                  3.7.400.34
AWS Amplify                        AMP         AWS.Tools.Amplify                 3.7.401.28
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.400.33
...

Para determinar a versão do PowerShell que você está executando, insira $PSVersionTable para visualizar o conteúdo da variável automática $PSVersionTable.

Por exemplo:

PS > $PSVersionTable

Name                           Value
----                           -----
PSVersion                      6.2.2
PSEdition                      Core
GitCommitId                    6.2.2
OS                             Darwin 18.7.0 Darwin Kernel Version 18.7.0: Tue Aug 20 16:57:14 PDT 2019; root:xnu-4903.271.2~2/RELEASE_X86_64
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

Atualizar o Ferramentas da AWS para PowerShell no Windows

Periodicamente, à medida que as versões atualizadas do Ferramentas da AWS para PowerShell são lançadas, é necessário atualizar a versão que está sendo executada localmente.

Atualizar os módulos AWS.Tools modularizados

A fim de atualizar os módulos AWS.Tools para a versão mais recente, execute o seguinte comando:

PS > Update-AWSToolsModule -CleanUp

Esse comando atualiza todos os AWS.Tools módulos instalados no momento e, após uma atualização bem-sucedida, remove outras versões instaladas.

Atualizar o Tools for PowerShell Core

Execute o cmdlet Get-AWSPowerShellVersion para determinar a versão que você está executando e compará-la com a versão do Tools for Windows PowerShell que está disponível no site Galeria do PowerShell. Sugerimos verificar a cada duas ou três semanas. O suporte para novos comandos e produtos da AWS estará disponível somente após a atualização para uma versão com esse suporte.

Antes de instalar uma versão mais recente do AWSPowerShell.NetCore, desinstale o módulo existente. Feche todas as sessões do PowerShell antes de desinstalar o pacote existente. Execute o seguinte comando para desinstalar o pacote.

PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

Depois de desinstalar o pacote, instale o módulo atualizado executando o comando a seguir.

PS > Install-Module -Name AWSPowerShell.NetCore

Após a instalação, execute o comando Import-Module AWSPowerShell.NetCore para carregar os cmdlets atualizados na sessão do PowerShell.

Atualizar o Tools for Windows PowerShell

Execute o cmdlet Get-AWSPowerShellVersion para determinar a versão que você está executando e compará-la com a versão do Tools for Windows PowerShell que está disponível no site Galeria do PowerShell. Sugerimos verificar a cada duas ou três semanas. O suporte para novos comandos e produtos da AWS estará disponível somente após a atualização para uma versão com esse suporte.

Após a instalação, execute o Import-Module AWSPowerShell para carregar os cmdlets atualizados na sessão do PowerShell. Ou execute o console personalizado do Ferramentas da AWS para PowerShell no menu Start (Iniciar).