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 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 compartilhados
.AWS.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:
-
Instale o PowerShell Core 6.0 ou posterior em um sistema compatível.
-
Depois de instalar o PowerShell Core, comece PowerShell executando
pwsh
no shell do sistema. -
Instale um
AWS.Tools
ou AWSPowerShell. NetCore. -
Execute o
Import-Module
cmdlet apropriado para importar o módulo para sua PowerShell sessão. -
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
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 outrosAWS.Tools
módulos.AWS.Tools.Installer
requerPowerShellGet
e baixa e instala automaticamente uma versão atualizada do mesmo.AWS.Tools.Installer
manté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 atualizamAWS.Tools.Installer
automaticamente todos os outrosAWS.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
-
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.
-
Para instalar o pacote
AWS.Tools
modularizado usando o móduloAWS.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 -
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 instalaAWS.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 doPSRepository
chamadoPSGallery
(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 essePSRepository
.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 Linuxno 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
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/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
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.