Instalar o AWSPower Shell no Windows PowerShell (antigo) - Ferramentas da AWS para PowerShell (versão 5)
Ativar a execução do scriptVersionamentoAtualizando Ferramentas da AWS para PowerShell

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.

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 o AWSPower Shell no Windows PowerShell (antigo)

Para obter informações gerais sobre a instalação do Ferramentas da AWS para PowerShell no Windows, incluindo pré-requisitos e outras opções, consulte o tópico principal.

Para obter informações sobre as ferramentas PowerShell que estão pré-instaladas AWS CloudShell, consulteInstalado em CloudShell.

nota

AWSPowerO shell não é o método recomendado para instalar Ferramentas da AWS para PowerShell o. Para obter o método recomendado, consulte Instalar AWS.Tools (recomendado) em vez disso.

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

  • Baixando o módulo do AWSPowerShell.zip e extraindo-o em um dos diretórios do módulo. É possível descobrir os diretórios do módulo exibindo o valor da variável de ambiente PSModulePath.

    Atenção

    Depois de baixar o arquivo ZIP e antes de extrair o conteúdo, talvez seja necessário desbloqueá-lo. Isso geralmente é feito abrindo as propriedades do arquivo, visualizando a guia Geral e marcando a caixa de seleção Desbloquear, se houver.

    Se o arquivo ZIP precisar ser desbloqueado, mas você não fizer isso, você poderá receber erros semelhantes aos seguintes: “Módulo de importação: não foi possível carregar o arquivo ou a montagem”.

  • Instalando a partir da PowerShell Galeria usando o Install-Module cmdlet conforme descrito no procedimento a seguir.

Para instalar o AWSPower Shell a partir da PowerShell Galeria usando o cmdlet Install-Module

Você pode instalar o AWSPower Shell a partir da PowerShell Galeria se estiver executando a PowerShell versão 5.0 ou posterior ou se tiver PowerShellGetinstalado a versão PowerShell 3 ou posterior. Você pode instalar e atualizar o AWSPower Shell a partir da PowerShellGaleria da Microsoft executando o seguinte comando.

 PS > Install-Module -Name AWSPowerShell

Para carregar automaticamente o módulo AWSPower Shell em uma PowerShell sessão, adicione o import-module cmdlet anterior ao seu PowerShell perfil. Para obter mais informações sobre como editar seu PowerShell perfil, consulte Sobre perfis na PowerShell documentação.

Ativar a execução do script

Para carregar os Ferramentas da AWS para PowerShell módulos, você deve habilitar a execução do PowerShell script. 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.

nota

Este é um requisito apenas para computadores que executam o Windows. A restrição de segurança ExecutionPolicy não está presente em outros sistemas operacionais.

Para ativar a execução do script

  1. São necessários direitos de administrador para definir a política de execução. Se você não estiver logado como usuário com direitos de administrador, abra uma PowerShell sessão como administrador. Escolha Start (Iniciar) e selecione All Programs (Todos os programas). Escolha Acessórios e, em seguida, escolha Windows PowerShell. Clique com o botão direito do mouse em Windows e PowerShell, no menu de contexto, escolha Executar como administrador.

  2. No prompt de comando, digite o seguinte.

    PS > Set-ExecutionPolicy RemoteSigned
nota

Em um sistema de 64 bits, você deve fazer isso separadamente para a versão de 32 bits do PowerShell Windows PowerShell (x86).

Se você não tiver a política de execução definida corretamente, PowerShell mostrará o erro a seguir sempre que você tentar executar um script, como 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 PowerShell instalador do Tools for Windows atualiza automaticamente o PSModulePath para incluir a localização do diretório que contém o AWSPowerShell módulo.

Como PSModulePath inclui a localização do diretório do AWS módulo, o Get-Module -ListAvailable cmdlet 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

AWS lança novas versões do Ferramentas da AWS para PowerShell periodicamente para oferecer suporte a novos AWS serviços e recursos. Para determinar a versão das Ferramentas que você instalou, execute o AWSPower ShellVersion cmdlet Get-.

Por exemplo:

PS > Get-AWSPowerShellVersion

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

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

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/main/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 -ListServiceVersionInfo parâmetro a um AWSPower ShellVersion comando Get- para ver uma lista dos AWS serviços que são suportados na 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 PowerShell que você está executando, insira $PSVersionTable para visualizar o conteúdo da variável automática $ PSVersion Table.

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

Atualizando 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, você deve atualizar a versão que está executando localmente.

Atualize as ferramentas para Windows PowerShell

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

  • Se você instalou usando o cmdlet Install-Module, execute os comandos a seguir.

    PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell

  • Se você instalou usando um arquivo ZIP baixado:

    1. Baixe a versão mais recente do PowerShell site Tools for. Compare o número da versão do pacote no nome do arquivo baixado com o número da versão obtido ao executar o cmdlet Get-AWSPowerShellVersion.

    2. Se a versão de download for maior do que a versão que você instalou, feche todos os PowerShell consoles do Tools for Windows.

    3. Instale a versão mais recente do Tools for Windows PowerShell.

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