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á. # Instalar `AWS.Tools` no Windows (recomendado) [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.](pstools-getting-set-up-windows.md) Para obter informações sobre as ferramentas PowerShell que estão pré-instaladas AWS CloudShell, consulte[Instalado em CloudShell](pstools-getting-set-up-cloudshell.md). Você pode instalar a versão modularizada do Ferramentas da AWS para PowerShell em computadores que executam o Windows com o Windows PowerShell 5.1 ou PowerShell Core 6.0 ou posterior. Para obter informações sobre como instalar o PowerShell Core, consulte [Instalando 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/v5/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”. + Instalando cada módulo de serviço da PowerShell Galeria usando o `Install-Module` cmdlet. **Para instalar `AWS.Tools` no Windows usando o módulo `AWS.Tools.Installer`** 1. Inicie uma PowerShell sessão. **nota** Recomendamos que você *não* execute PowerShell como administrador com permissões elevadas, exceto quando exigido pela tarefa em 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 PowerShell a instalação do 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 AWS serviço que você deseja usar usando o `Install-AWSToolsModule` cmdlet. 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 AWS de serviço. 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 `Install-AWSToolsModule` cmdlet baixa todos os módulos solicitados do `PSRepository` nome `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e o considera 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, você deve executar o comando a seguir em uma PowerShell sessão iniciada 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 na [PowerShell Galeria](https://www.powershellgallery.com/packages?q=aws). ## 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](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. 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**. 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**). 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](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_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-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html). 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-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) 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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) \$1 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. ### 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 atualmente instalados e, após uma atualização bem-sucedida, remove as versões anteriores. **nota** O `Update-AWSToolsModule` cmdlet baixa todos os módulos do `PSRepository` nome `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e o considera uma fonte confiável. Use o `Get-PSRepository -Name PSGallery` comando para obter mais informações sobre isso`PSRepository`.