Instale o AWSPower Shell. NetCore no Linux ou macOS - Ferramentas da AWS para PowerShell (versão 5)
Execução do scriptConfigurando o console PowerShell Inicialize sua sessão PowerShell VersionamentoAtualizando o Ferramentas da AWS para PowerShell no Linux ou no macOSInformações relacionadas

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o tópico de migração.

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

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.

Para obter informações sobre as ferramentas PowerShell que estão pré-instaladas AWS CloudShell, consulteInstalado em CloudShell.

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) em vez disso.

Para atualizar para uma versão mais recente do AWSPower Shell. NetCore, siga as instruções emAtualizando o Ferramentas da AWS para PowerShell no Linux ou no macOS. 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 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ç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.

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 para especificar qual chave de acesso usar. AWS Para obter mais informações sobre o Initialize-AWSDefaultConfiguration, consulte Usando AWS credenciais.

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

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

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

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