Instalando AWS Tools for PowerShell no Linux ou macOS

Este tópico fornece instruções sobre como instalar o AWS Tools for PowerShell no Linux ou no macOS.

Visão geral da configuração

Para instalar AWS Tools for PowerShell em um computador Linux ou macOS, você pode escolher entre duas opções de pacote:

• AWS.Tools— A versão modularizada do. AWS Tools for PowerShell Cada AWS serviço é suportado por seu próprio módulo pequeno e individual, com módulos de suporte compartilhadosAWS.Tools.Common.

• AWSPowerShell. NetCore— A versão única e de módulo grande do. AWS Tools for 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. Em vez disso, use a versão modularizada mostrada acima.

A respectiva configuração em um computador com Linux ou macOS envolve as seguintes tarefas, descritas em detalhes posteriormente nesse tópico:

1. Instale o PowerShell Core 6.0 ou posterior em um sistema compatível.

2. Depois de instalar o PowerShell Core, comece PowerShell executando pwsh no shell do sistema.

3. Instale um AWS.Tools ou AWSPowerShell. NetCore.

4. Execute o Import-Module cmdlet apropriado para importar o módulo para sua PowerShell sessão.

5. Execute o AWSDefaultConfiguration cmdlet Initialize- 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 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 da Microsoft.

Instalar o AWS.Tools no Linux ou no macOS

Você pode instalar a versão modularizada do AWS Tools for 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 no PowerShell site da Microsoft.

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

• Usando os cmdlets do módulo AWS.Tools.Installer. Esse módulo simplifica a instalação e a atualização de outros AWS.Tools módulos. AWS.Tools.Installerrequer PowerShellGet e baixa e instala automaticamente uma versão atualizada do mesmo. AWS.Tools.Installermantém automaticamente as versões do seu módulo sincronizadas. Quando você instala ou atualiza para uma versão mais recente de um módulo, os cmdlets atualizam AWS.Tools.Installer automaticamente todos os outros AWS.Tools módulos para a mesma versão.

  Esse método é descrito no procedimento a seguir.

• Download dos módulos de 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.

2. 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á solicitado a confirmar se deseja prosseguir com a instalação. 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

3. 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 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 cmdlet Install-AWSToolsModule faz download de todos os módulos solicitados do PSRepository chamado PSGallery (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 PowerShell versão instalada. 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 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.

Instalar AWSPowerShell. NetCore no Linux ou macOS

Para atualizar para uma versão mais recente do. AWSPowerShell NetCore, siga as instruções emAtualizando o AWS Tools for PowerShell no Linux ou no macOS. Desinstale as versões anteriores do AWSPowerShell. NetCore primeiro.

Você pode instalar AWSPowerShell. NetCore em uma das duas formas:

• Download do módulo de 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 AWSPowerShell. 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 AWSPowerShell o. 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á solicitado a confirmar se deseja prosseguir com a instalação. 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 AWS Tools for 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çousudo 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 executarGet-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 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…

AWSPowerShell.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 AWSPowerShell. NetCore por causa de seu grande tamanho. Para começar a correr AWSPowerShell. 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 AWS Tools for PowerShell, você deve executar Initialize- AWSDefaultConfiguration para especificar qual chave de acesso usar. AWS Para obter mais informações sobre o Initialize-AWSDefaultConfiguration, consulte Usar credenciais da AWS.

nota

Nas versões anteriores (antes da 3.3.96.0) do AWS Tools for PowerShell, esse cmdlet foi nomeado. Initialize-AWSDefaults

Versionamento

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

PS > Get-AWSPowerShellVersion

Tools for PowerShell
Version 4.0.123.0
Copyright 2012-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.

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

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/master/CHANGELOG.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 AWSPowerShellVersion cmdlet Get-.

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

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 AWS Tools for PowerShell no Linux ou no macOS

Periodicamente, à medida que as versões atualizadas do AWS Tools for PowerShell são lançadas, você deve atualizar a versão que está executando localmente.

Atualize os módulos modularizados AWS.Tools

Para atualizar seus AWS.Tools módulos para a versão mais recente, execute o seguinte comando:

PS > Update-AWSToolsModule -CleanUp

Esse comando atualiza todos os módulos AWS.Tools instalados atualmente e, para os módulos que foram atualizados com êxito, remove as versões anteriores.

nota

O cmdlet Update-AWSToolsModule faz download de todos os módulos do PSRepository chamado PSGallery (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.

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

• Conceitos básicos da AWS Tools for Windows PowerShell

• Trabalhar com serviços da AWS no AWS Tools for PowerShell