Ferramentas da AWS para PowerShell O V4 entrou no modo de manutenção. Recomendamos que você migre para a [Ferramentas da AWS para PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Para obter detalhes e informações adicionais sobre como migrar, consulte nosso [anúncio do modo de manutenção](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/). 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: + [**`AWS.Tools`**](#ps-installing-awstools) - a versão modularizada do Ferramentas da AWS para PowerShell. Cada serviço da AWS é compatível com seu próprio módulo individual pequeno, com os módulos compartilhados de suporte `AWS.Tools.Common` e `AWS.Tools.Installer`. + [**AWSPowerShell.NetCore**](#ps-installing-awspowershellnetcore): a versão de módulo único do Ferramentas da AWS para PowerShell. Todos os serviços da AWS são compatíveis com esse único módulo grande. **nota** Esteja ciente de que o módulo único pode ser muito grande para ser usado com funções [AWS Lambda](https://aws.amazon.com/lambda/). Em vez disso, use a versão modularizada mostrada acima. + [**AWSPowerShell**](#ps-installing-awswindowspowershell): a versão legada de módulo grande e único do Ferramentas da AWS para PowerShell específica do Windows. Todos os serviços da AWS são compatíveis com esse único módulo grande. O pacote escolhido depende da versão e edição do Windows sendo executado. **nota** O Ferramentas da AWS para PowerShell é instalado por padrão em todas as imagens de máquina da Amazon (AMIs) do Windows. A opção instalada depende da AMI. Muitas AMIs têm o módulo AWSPowerShell, mas algumas podem ter uma opção diferente. Por exemplo, as AMIs do Amazon EC2 para Windows Server 2025 usam a opção modular `AWS.Tools`. A configuração do Ferramentas da AWS para PowerShell envolve as tarefas de alto nível descritas em detalhes a seguir nesse tópico. 1. Instale a opção de pacote do Ferramentas da AWS para PowerShell que seja apropriada para o seu ambiente. 1. Verifique se a execução do script está habilitada ao executar o cmdlet `Get-ExecutionPolicy`. 1. Importe o módulo do Ferramentas da AWS para PowerShell para a sua sessão do PowerShell. ## 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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) no site da Microsoft. Você pode instalar o `AWS.Tools` de três maneiras: + Usando os cmdlets do módulo `AWS.Tools.Installer`. Este módulo `AWS.Tools` simplifica a instalação e a atualização de outros módulos. O `AWS.Tools.Installer` exige `PowerShellGet`, e automaticamente baixa e instala uma versão atualizada dele. O `AWS.Tools.Installer` mantém automaticamente as versões do módulo sincronizadas. Quando você instala ou atualiza para uma nova versão de um módulo, os cmdlets em `AWS.Tools.Installer` atualizam automaticamente todos os outros módulos `AWS.Tools` para a mesma versão. Esse método está descrito no procedimento a seguir. + Baixando os módulos de `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWS.Tools.zip)` e extração em uma das pastas do módulo. É possível descobrir as pastas de módulo exibindo o valor da variável de ambiente `PSModulePath`. **Atenção** Depois do download do arquivo ZIP e antes da extração do conteúdo, talvez seja necessário desbloqueá-lo. Isso costuma ser feito abrindo as propriedades do arquivo, exibindo 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: “Import-Module : não foi possível carregar o arquivo ou o assembly”. + Instalação de cada módulo de serviço na Galeria do PowerShell usando o cmdlet `Install-Module`. **Para instalar `AWS.Tools` no Windows usando o módulo `AWS.Tools.Installer`** 1. Inicie uma sessão do PowerShell. **nota** Recomendamos que você *não* execute o PowerShell como um administrador com permissões elevadas, exceto quando for exigido pela tarefa m questão. Isso se deve ao risco potencial de segurança e é consistente com o princípio do privilégio mínimo. 1. Para instalar o pacote do `AWS.Tools` modularizado, execute o comando a seguir. ``` PS > Install-Module -Name AWS.Tools.Installer Untrusted repository You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): y ``` Se for notificado de que o repositório é "não confiável", você será solicitado a confirmar se deseja instalar de qualquer maneira. Digite **y** para permitir que o PowerShell instale o módulo. Para evitar o prompt e instalar o módulo sem confiar no repositório, você pode executar o comando com o parâmetro `-Force`. ``` PS > Install-Module -Name AWS.Tools.Installer -Force ``` 1. Agora você pode instalar o módulo para cada serviço da AWS que deseja usar com o cmdlet `Install-AWSToolsModule`. Por exemplo, o comando a seguir instala os módulos do Amazon EC2 e do Amazon S3. Esse comando também instala todos os módulos dependentes que são exigidos para que o módulo especificado funcione. Por exemplo, ao instalar o primeiro módulo do serviço `AWS.Tools`, ele também instala `AWS.Tools.Common`. Esse é um módulo compartilhado exigido por todos os módulos de serviço da AWS. Ele também remove as versões mais antigas dos módulos e atualiza outros módulos para a mesma versão mais recente. ``` PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp Confirm Are you sure you want to perform this action? Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Installing module AWS.Tools.Common version 4.0.0.0 Installing module AWS.Tools.EC2 version 4.0.0.0 Installing module AWS.Tools.Glacier version 4.0.0.0 Installing module AWS.Tools.S3 version 4.0.0.0 Uninstalling AWS.Tools version 3.3.618.0 Uninstalling module AWS.Tools.Glacier Uninstalling module AWS.Tools.S3 Uninstalling module AWS.Tools.SimpleNotificationService Uninstalling module AWS.Tools.SQS Uninstalling module AWS.Tools.Common ``` **nota** O cmdlet `Install-AWSToolsModule` faz download de todos os módulos solicitados do `PSRepository` chamado `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e o considera como uma fonte confiável. Use o comando `Get-PSRepository -Name PSGallery` para obter mais informações sobre esse `PSRepository`. Por padrão, o comando anterior instala módulos na pasta `%USERPROFILE%\Documents\WindowsPowerShell\Modules`. Para instalar o Ferramentas da AWS para PowerShell para todos os usuários de um computador, é necessário executar o comando a seguir em uma sessão do PowerShell que você iniciou como administrador. Por exemplo, o comando a seguir instala o módulo do IAM na pasta `%ProgramFiles%\WindowsPowerShell\Modules` que pode ser acessada por todos os usuários. ``` PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers ``` Para instalar outros módulos, execute comandos semelhantes com os nomes de módulo apropriados, conforme encontrado em [PowerShell Gallery](https://www.powershellgallery.com/packages?q=aws). ## 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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) no site do Microsoft PowerShell. É possível instalar o AWSPowerShell.NetCore de uma duas formas + Baixando o módulo [AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWSPowerShell.NetCore.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 do download do arquivo ZIP e antes da extração do conteúdo, talvez seja necessário desbloqueá-lo. Isso costuma ser feito abrindo as propriedades do arquivo, exibindo 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: “Import-Module : não foi possível carregar o arquivo ou o assembly”. + Instalando a partir da Galeria do PowerShell usando o cmdlet `Install-Module`, conforme descrito no procedimento a seguir. **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](https://www.powershellgallery.com/packages/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)](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles) na documentação do PowerShell. ## Instalar o AWSPowerShell no Windows PowerShell Você pode instalar o AWS Tools for Windows PowerShell de duas maneiras: + Baixando o módulo de [AWSPowerShell.zip](https://sdk-for-net.amazonwebservices.com/ps/v4/latest/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 do download do arquivo ZIP e antes da extração do conteúdo, talvez seja necessário desbloqueá-lo. Isso costuma ser feito abrindo as propriedades do arquivo, exibindo 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: “Import-Module : não foi possível carregar o arquivo ou o assembly”. + Instalando a partir da Galeria do PowerShell usando o cmdlet `Install-Module` conforme descrito no procedimento a seguir. **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](https://www.powershellgallery.com/packages/PowerShellGet) no PowerShell 3 ou posterior. Você pode instalar e atualizar o AWSPowerShell a partir da [Galeria do PowerShell](https://www.powershellgallery.com/packages/AWSPowerShell) 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)](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6) na documentação do PowerShell. **nota** O Tools for Windows PowerShell é instalado por padrão em todas as imagens de máquina da Amazon (AMIs) baseadas em Windows. ## 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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/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. Caso não esteja conectado como usuário com direitos de administrador, abra uma sessão do PowerShell como Administrador. Escolha **Start (Iniciar)** e selecione **All Programs (Todos os programas)**. Escolha **Accessories (Acessórios)** e selecione **Windows PowerShell**. Clique com o botão direito em **Windows PowerShell** e, no menu de contexto, escolha **Run as administrator (Executar como administrador)**. 1. 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)**. 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](http://msdn.microsoft.com/en-us/library/windows/desktop/dd878326.aspx) 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](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-AWSPowerShellVersion.html): 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](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-AWSPowerShellVersion.html) 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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) $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. **nota** O cmdlet `Update-AWSToolsModule` faz download de todos os módulos do `PSRepository` chamado `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e o considera como uma fonte confiável. Use o comando: `Get-PSRepository -Name PSGallery` para obter mais informações sobre esse `PSRepository`. ### 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](https://www.powershellgallery.com/packages/AWSPowerShell). 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](https://www.powershellgallery.com/packages/AWSPowerShell). 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. + 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. Faça download da versão mais recente do site do [Tools for PowerShell](https://aws.amazon.com/powershell/). 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`. 1. Se a versão baixada for um número mais alto que a versão instalada, feche todos os consoles do Tools for Windows PowerShell. 1. Instale a versão mais recente do Tools for Windows PowerShell. 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)**.