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á. # Instalando Ferramentas da AWS para PowerShell no Linux ou macOS 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). Para instalar Ferramentas da AWS para PowerShell em um computador Linux ou macOS, você pode escolher entre duas opções de pacote: + [**`AWS.Tools`**](install-aws.tools-on-linux-macos.md)— A versão modularizada do. Ferramentas da AWS para PowerShell Cada AWS serviço é suportado por seu próprio módulo pequeno e individual, com módulos de suporte compartilhados`AWS.Tools.Common`. + [**AWSPowerConcha. NetCore**](install-netcore-on-linux-macos.md) — A versão única e de módulo grande do. Ferramentas da AWS para PowerShell Todos os AWS serviços são suportados por esse módulo único e 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. Configurar qualquer um deles em um computador executando Linux ou macOS envolve as seguintes tarefas, descritas em detalhes nos tópicos subsequentes: 1. Instale o PowerShell Core 6.0 ou posterior em um sistema compatível. 1. Depois de instalar o PowerShell Core, comece PowerShell executando `pwsh` no shell do sistema. 1. Instale um `AWS.Tools` ou o AWSPower Shell. NetCore. 1. Execute o `Import-Module` cmdlet apropriado para importar o módulo para sua PowerShell sessão. 1. Execute o cmdlet [AWSDefaultInitialize-Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) para fornecer suas credenciais. AWS ## Pré-requisitos Para executar o AWS Tools for PowerShell Core, seu computador deve estar executando o PowerShell Core 6.0 ou posterior. + Para obter uma lista das versões suportadas da plataforma Linux e obter informações sobre como instalar a versão mais recente do PowerShell em um computador baseado em Linux, consulte [Instalando PowerShell no Linux no site](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-linux) da Microsoft. Alguns sistemas operacionais baseados em Linux, como Arch, Kali e Raspbian, não são oficialmente compatíveis, mas têm níveis variáveis de suporte da comunidade. + Para obter informações sobre as versões compatíveis do macOS e sobre como instalar a versão mais recente do no PowerShell macOS, consulte Instalação [no PowerShell macOS no site](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-macos) da Microsoft. **Topics** + [Pré-requisitos](#prerequisites) + [Instalar `AWS.Tools` (recomendado)](install-aws.tools-on-linux-macos.md) + [Instale o AWSPower Shell. NetCore](install-netcore-on-linux-macos.md) # Instale `AWS.Tools` no Linux ou macOS (recomendado) [Para obter informações gerais sobre a instalação do Ferramentas da AWS para PowerShell no Linux ou no macOS, incluindo pré-requisitos e outras opções, consulte o tópico principal.](pstools-getting-set-up-linux-mac.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 estejam executando o 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 PowerShell 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. + Download dos módulos de `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)` e extração em um dos diretórios do módulo. Você pode descobrir seus diretórios de módulo imprimindo o valor da variável `$Env:PSModulePath`. + Instalando cada módulo de serviço da PowerShell Galeria usando o `Install-Module` cmdlet. **Para instalar `AWS.Tools` no Linux ou no macOS usando o módulo `AWS.Tools.Installer`** 1. Inicie uma sessão PowerShell principal executando o comando a seguir. ``` $ pwsh ``` **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 `AWS.Tools` modularizado usando o módulo `AWS.Tools.Installer`, 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 você for notificado de que o repositório é “não confiável”, você será perguntado se deseja instalar mesmo assim. 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 a seguir. ``` PS > Install-Module -Name AWS.Tools.Installer -Force ``` 1. Agora você pode instalar o módulo para cada serviço que deseja usar. 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 `Install-AWSToolsModule` cmdlet baixa todos os módulos solicitados do `PSRepository` nome `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e considera o repositório como uma fonte confiável. Use o comando `Get-PSRepository -Name PSGallery` para obter mais informações sobre esse `PSRepository`. O comando anterior instala os módulos nos diretórios-padrão do seu sistema. Os diretórios reais dependem da distribuição e da versão do sistema operacional e da versão PowerShell que você instalou. Por exemplo, se você instalou o PowerShell 7 em um sistema semelhante ao RHEL, os módulos padrão provavelmente estão localizados em `/opt/microsoft/powershell/7/Modules` (ou`$PSHOME/Modules`) e os módulos de usuário provavelmente estão localizados em. `~/.local/share/powershell/Modules` Para obter mais informações, consulte [Instalar PowerShell no Linux](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-linux) no PowerShell site da Microsoft. Para ver onde os módulos estão instalados, execute o seguinte comando: ``` PS > Get-Module -ListAvailable ``` 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). ## Execução do script O comando `Set-ExecutionPolicy` não está disponível em sistemas que não sejam Windows. Você pode executar`Get-ExecutionPolicy`, o que mostra que a configuração padrão da política de execução no PowerShell Core em execução em sistemas não Windows é`Unrestricted`. Para obter mais informações, consulte [About Execution Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1) no site da Microsoft Technet. Como `PSModulePath` inclui a localização do diretório do AWS módulo, o `Get-Module -ListAvailable` cmdlet mostra o módulo que você instalou. **`AWS.Tools`** ``` PS > Get-Module -ListAvailable Directory: /Users/username/.local/share/powershell/Modules ModuleType Version Name PSEdition ExportedCommands ---------- ------- ---- --------- ---------------- Binary 3.3.563.1 AWS.Tools.Common Desk {Clear-AWSHistory, Set-AWSHistoryConfiguration, Initialize-AWSDefaultConfiguration, Clear-AWSDefaultConfigurat… ``` ## Inicialize sua sessão PowerShell Ao iniciar PowerShell em um sistema baseado em Linux ou macOS depois de instalar o Ferramentas da AWS para PowerShell, você deve executar [Initialize- AWSDefault Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) para especificar qual chave de acesso usar. AWS Para saber mais sobre o `Initialize-AWSDefaultConfiguration`, consulte [Usando AWS credenciais](specifying-your-aws-credentials.md). **nota** Nas versões anteriores (antes da 3.3.96.0) do Ferramentas da AWS para PowerShell, esse cmdlet foi nomeado. `Initialize-AWSDefaults` ## 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 do Ferramentas da AWS para PowerShell 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] ``` Para ver uma lista dos AWS serviços suportados na versão atual das ferramentas, adicione o `-ListServiceVersionInfo` parâmetro a um AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html). Para determinar a versão PowerShell que você está executando, insira `$PSVersionTable` para visualizar o conteúdo da [variável `$PSVersionTable` automática](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6). 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 Linux ou no macOS 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`. ## Informações relacionadas + [Configurando e usando o Ferramentas da AWS para PowerShell](pstools-getting-started.md) + [AWS Serviços de chamadas no Ferramentas da AWS para PowerShell](pstools-using.md) # Instale o AWSPower Shell. NetCore no Linux ou macOS [Para obter informações gerais sobre a instalação do Ferramentas da AWS para PowerShell no Linux ou no macOS, incluindo pré-requisitos e outras opções, consulte o tópico principal.](pstools-getting-set-up-linux-mac.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). **nota** AWSPowerConcha. NetCore 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)](install-aws.tools-on-linux-macos.md) em vez disso. Para atualizar para uma versão mais recente do AWSPower Shell. NetCore, siga as instruções em[Atualizando o Ferramentas da AWS para PowerShell no Linux ou no macOS](#pstools-updating-linux-netcore). Desinstale as versões anteriores do AWSPower Shell. NetCore primeiro. Você pode instalar o AWSPower Shell. NetCore em uma das duas formas: + Download do módulo de `[AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip)` e extração em um dos diretórios do módulo. Você pode descobrir seus diretórios de módulo imprimindo o valor da variável `$Env:PSModulePath`. + Instalando a partir da PowerShell Galeria usando o `Install-Module` cmdlet conforme descrito no procedimento a seguir. **Para instalar o AWSPower Shell. NetCore no Linux ou macOS usando o cmdlet Install-Module** Inicie uma sessão PowerShell principal executando o comando a seguir. ``` $ pwsh ``` **nota** Recomendamos que você *não* comece PowerShell correndo `sudo pwsh` para executar PowerShell com direitos de administrador elevados. Isso se deve ao risco potencial de segurança e é consistente com o princípio do privilégio mínimo. Para instalar o AWSPower Shell. NetCore pacote de módulo único da PowerShell Galeria, execute o seguinte comando. ``` PS > Install-Module -Name AWSPowerShell.NetCore 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 você for notificado de que o repositório é “não confiável”, você será perguntado se deseja instalar mesmo assim. Digite **y** para permitir PowerShell a instalação do módulo. Para evitar o prompt sem confiar no repositório, você pode executar o comando a seguir. ``` PS > Install-Module -Name AWSPowerShell.NetCore -Force ``` Você não precisa executar esse comando como root, a menos que queira instalá-lo Ferramentas da AWS para PowerShell para todos os usuários de um computador. Para fazer isso, execute o comando a seguir em uma PowerShell sessão com a qual você começou`sudo pwsh`. ``` PS > Install-Module -Scope AllUsers -Name AWSPowerShell.NetCore -Force ``` ## Execução do script O comando `Set-ExecutionPolicy` não está disponível em sistemas que não sejam Windows. Você pode executar`Get-ExecutionPolicy`, o que mostra que a configuração padrão da política de execução no PowerShell Core em execução em sistemas não Windows é`Unrestricted`. Para obter mais informações, consulte [About Execution Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1) no site da Microsoft Technet. Como `PSModulePath` inclui a localização do diretório do AWS módulo, o `Get-Module -ListAvailable` cmdlet mostra o módulo que você instalou. **AWSPowerConcha. NetCore** ``` PS > Get-Module -ListAvailable Directory: /Users/username/.local/share/powershell/Modules ModuleType Version Name ExportedCommands ---------- ------- ---- ---------------- Binary 3.3.563.1 AWSPowerShell.NetCore ``` ## Configure um PowerShell console para usar o AWS Tools for PowerShell Core (AWSPowerShell). NetCore Somente) PowerShell O Core normalmente carrega módulos automaticamente sempre que você executa um cmdlet no módulo. Mas isso não funciona para a AWSPower Shell. NetCore por causa de seu grande tamanho. Para começar a executar o AWSPower Shell. NetCore cmdlets, você deve primeiro executar o `Import-Module AWSPowerShell.NetCore` comando. Isso não é necessário para cmdlets nos módulos do `AWS.Tools`. ## Inicialize sua sessão PowerShell Ao iniciar PowerShell em um sistema baseado em Linux ou macOS depois de instalar o Ferramentas da AWS para PowerShell, você deve executar [Initialize- AWSDefault Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) para especificar qual chave de acesso usar. AWS Para saber mais sobre o `Initialize-AWSDefaultConfiguration`, consulte [Usando AWS credenciais](specifying-your-aws-credentials.md). **nota** Nas versões anteriores (antes da 3.3.96.0) do Ferramentas da AWS para PowerShell, esse cmdlet foi nomeado. `Initialize-AWSDefaults` ## 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 do Ferramentas da AWS para PowerShell 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] ``` Para ver uma lista dos AWS serviços suportados na versão atual das ferramentas, adicione o `-ListServiceVersionInfo` parâmetro a um AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html). Para determinar a versão PowerShell que você está executando, insira `$PSVersionTable` para visualizar o conteúdo da [variável `$PSVersionTable` automática](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6). 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 Linux ou no macOS 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 do PowerShell Core 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](https://www.powershellgallery.com/packages/AWSPowerShell). 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. Antes de instalar uma versão mais recente do AWSPower Shell. NetCore, desinstale o módulo existente. Feche todas PowerShell as sessões abertas 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 em sua PowerShell sessão. ## Informações relacionadas + [Configurando e usando o Ferramentas da AWS para PowerShell](pstools-getting-started.md) + [AWS Serviços de chamadas no Ferramentas da AWS para PowerShell](pstools-using.md)