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á.
# Comece com o Ferramentas da AWS para PowerShell
Os tópicos a seguir mostram como instalar com êxito os Ferramentas da AWS para PowerShell cmdlets e configurar a autenticação com. AWS
**Topics**
+ [Instalado em CloudShell](pstools-getting-set-up-cloudshell.md)
+ [Instalar no Windows](pstools-getting-set-up-windows.md)
+ [Instalar no Linux ou no macOS](pstools-getting-set-up-linux-mac.md)
+ [Autenticando com AWS](creds-idc.md)
# Instalado Ferramentas da AWS para PowerShell em AWS CloudShell
`AWS.Tools`é pré-instalado AWS CloudShell conforme descrito em [Software pré-instalado no Guia](https://docs.aws.amazon.com/cloudshell/latest/userguide/vm-specs.html#pre-installed-software) do [AWS CloudShell usuário](https://docs.aws.amazon.com/cloudshell/latest/userguide/). Como as credenciais do console são passadas automaticamente para CloudShell, um usuário com permissões para abrir CloudShell pode executar imediatamente o Tools for PowerShell cmdlets sem instalação ou configuração adicional.
Para usar o Ferramentas da AWS para PowerShell ativado CloudShell, execute etapas semelhantes às seguintes:
1. Abra o [CloudShellconsole](https://console.aws.amazon.com/cloudshell/home).
1. Executar `pwsh`.
1. Execute todos `AWS.Tools` PowerShell os comandos necessários, como`Get-S3Bucket`.
# Instalando o Ferramentas da AWS para PowerShell no Windows
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).
Um computador baseado em Windows pode executar qualquer uma das opções de pacote: Ferramentas da AWS para PowerShell
+ [**`AWS.Tools`**](ps-installing-awstools.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` `AWS.Tools.Installer` e.
+ [**AWSPowerConcha. NetCore**](ps-installing-awspowershellnetcore.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.
+ [**AWSPowerShell**](ps-installing-awswindowspowershell.md) - A versão antiga, específica para Windows, de módulo único e grande do. Ferramentas da AWS para PowerShell Todos os AWS serviços são suportados por esse módulo único e grande.
O pacote escolhido depende da versão e da edição do Windows que você está executando.
**nota**
Eles Ferramentas da AWS para PowerShell são instalados por padrão em todas as Amazon Machine Images AMIs () baseadas em Windows. A opção instalada depende da AMI. Muitos AMIs têm o módulo AWSPower Shell, mas alguns podem ter uma opção diferente. Por exemplo, a Amazon EC2 AMIs para Windows Server 2025 usa a `AWS.Tools` opção modular.
A configuração do Ferramentas da AWS para PowerShell envolve as seguintes tarefas de alto nível, descritas em detalhes nos tópicos subsequentes.
1. Instale a opção de Ferramentas da AWS para PowerShell pacote apropriada para seu ambiente.
1. Verifique se a execução do script está habilitada ao executar o cmdlet `Get-ExecutionPolicy`.
1. Importe o Ferramentas da AWS para PowerShell módulo para sua PowerShell sessão.
## Pré-requisitos
Versões mais recentes do PowerShell, incluindo o PowerShell Core, estão disponíveis como downloads na Microsoft em [Instalando várias versões do PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) no site da Microsoft.
**Topics**
+ [Pré-requisitos](#prerequisites)
+ [Instalar `AWS.Tools` (recomendado)](ps-installing-awstools.md)
+ [Instale o AWSPower Shell. NetCore](ps-installing-awspowershellnetcore.md)
+ [Instale o AWSPower Shell (legado)](ps-installing-awswindowspowershell.md)
# 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`.
# Instale o AWSPower Shell. NetCore no Windows
[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).
**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)](ps-installing-awstools.md) em vez disso.
Você pode instalar o AWSPower Shell. NetCore em computadores que executam o Windows com a PowerShell versão 3 a 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 PowerShell site da Microsoft.
Você pode instalar o AWSPower Shell. NetCore em uma das duas maneiras
+ Baixando o módulo do [AWSPowerShell. NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip) e extraindo-o em um dos diretórios do módulo. É possível descobrir os diretórios do módulo exibindo o valor da variável de ambiente `PSModulePath`.
**Atenção**
Depois de baixar o arquivo ZIP e antes de extrair o conteúdo, talvez seja necessário desbloqueá-lo. Isso geralmente é feito abrindo as propriedades do arquivo, visualizando 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: “Módulo de importação: não foi possível carregar o arquivo ou a montagem”.
+ Instalando a partir da PowerShell Galeria usando o `Install-Module` cmdlet, conforme descrito no procedimento a seguir.
**Para instalar o AWSPower Shell. NetCore da PowerShell Galeria usando o cmdlet Install-Module**
Para instalar o AWSPower Shell. NetCore da PowerShell Galeria, seu computador deve estar executando a PowerShell versão 5.0 ou posterior ou a versão PowerShell 3 ou posterior. [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet) Execute o seguinte comando:
```
PS > Install-Module -name AWSPowerShell.NetCore
```
Se você estiver executando PowerShell como administrador, o comando anterior será instalado Ferramentas da AWS para PowerShell para todos os usuários no computador. Se você estiver executando PowerShell como um usuário padrão sem permissões de administrador, esse mesmo comando será instalado somente Ferramentas da AWS para PowerShell para o usuário atual.
Para instalar apenas para o usuário atual quando esse usuário tiver permissões de administrador, execute o comando com o conjunto de parâmetros do `-Scope CurrentUser` conforme indicado a seguir.
```
PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser
```
Embora as versões PowerShell 3.0 e posteriores normalmente carreguem módulos em sua PowerShell sessão na primeira vez em que você executa um cmdlet no módulo, o AWSPower Shell. NetCore o módulo é muito grande para suportar essa funcionalidade. Em vez disso, você deve carregar explicitamente o AWSPower Shell. NetCore Módulo principal em sua PowerShell sessão executando o comando a seguir.
```
PS > Import-Module AWSPowerShell.NetCore
```
Para carregar o AWSPower Shell. NetCore módulo em uma PowerShell sessão automaticamente, adicione esse comando ao seu PowerShell perfil. Para obter mais informações sobre como editar seu PowerShell perfil, consulte [Sobre perfis](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles) na PowerShell documentação.
## 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.
### 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.
# Instalar o AWSPower Shell no Windows PowerShell (antigo)
[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).
**nota**
AWSPowerO shell 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)](ps-installing-awstools.md) em vez disso.
Você pode instalar o AWS Tools for Windows PowerShell de duas maneiras:
+ Baixando o módulo do [AWSPowerShell.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.zip) e extraindo-o em um dos diretórios do módulo. É possível descobrir os diretórios do 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 a partir da PowerShell Galeria usando o `Install-Module` cmdlet conforme descrito no procedimento a seguir.
**Para instalar o AWSPower Shell a partir da PowerShell Galeria usando o cmdlet Install-Module**
Você pode instalar o AWSPower Shell a partir da PowerShell Galeria se estiver executando a PowerShell versão 5.0 ou posterior ou se tiver [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet)instalado a versão PowerShell 3 ou posterior. Você pode instalar e atualizar o AWSPower Shell a partir da [PowerShellGaleria](https://www.powershellgallery.com/packages/AWSPowerShell) da Microsoft executando o comando a seguir.
```
PS > Install-Module -Name AWSPowerShell
```
Para carregar automaticamente o módulo AWSPower Shell em uma PowerShell sessão, adicione o `import-module` cmdlet anterior ao seu PowerShell perfil. Para obter mais informações sobre como editar seu PowerShell perfil, consulte [Sobre perfis](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6) na PowerShell documentação.
## 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.
### Atualize as ferramentas para Windows PowerShell
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.
+ Se você instalou usando o cmdlet `Install-Module`, execute os comandos a seguir.
```
PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell
```
+ Se você instalou usando um arquivo ZIP baixado:
1. Baixe a versão mais recente do PowerShell site [Tools for](https://aws.amazon.com/powershell/). Compare o número da versão do pacote no nome do arquivo baixado com o número da versão obtido ao executar o cmdlet `Get-AWSPowerShellVersion`.
1. Se a versão de download for maior do que a versão que você instalou, feche todos os PowerShell consoles do Tools for Windows.
1. Instale a versão mais recente do Tools for Windows PowerShell.
Após a instalação, execute `Import-Module AWSPowerShell` para carregar os cmdlets atualizados em sua PowerShell sessão. Ou execute o Ferramentas da AWS para PowerShell console personalizado no menu **Iniciar**.
# 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)
# Autenticando o com Ferramentas da AWS para PowerShell AWS
Você deve estabelecer como seu código é autenticado AWS ao desenvolver com Serviços da AWS. Há diferentes maneiras de configurar o acesso programático aos AWS recursos, dependendo do ambiente e do AWS acesso disponível para você.
Para ver vários métodos de autenticação do Tools for PowerShell, consulte [Autenticação e acesso](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) no *Guia de referência de ferramentas AWS SDKs e ferramentas*.
Este tópico pressupõe que um novo usuário esteja se desenvolvendo localmente, não tenha recebido um método de autenticação do empregador e o usará Centro de Identidade do AWS IAM para obter credenciais temporárias. Se seu ambiente não se enquadra nessas suposições, algumas das informações neste tópico podem não se aplicar a você ou algumas das informações podem já ter sido fornecidas.
A configuração desse ambiente requer várias etapas, que são resumidas da seguinte forma:
1. [Faça login usando as credenciais do console](#login-con-creds)
1. [Habilitar e configurar o Centro de Identidade do IAM](#idc-config-sso)
1. [Configure as ferramentas PowerShell para usar o IAM Identity Center.](#idc-config-sdk)
1. [Iniciar uma sessão do portal de AWS acesso](#idc-start-portal)
## Faça login usando as credenciais do console
Você pode usar suas credenciais de login existentes do AWS Management Console para acesso programático a. Serviços da AWS Depois de um fluxo de autenticação baseado em navegador, Ferramentas da AWS para PowerShell gera credenciais temporárias que funcionam em ferramentas de desenvolvimento locais, como, e. AWS SDKs Ferramentas da AWS para PowerShell AWS CLI Esse recurso simplifica o processo de configuração e gerenciamento de credenciais da CLI, especialmente se você preferir usar a autenticação interativa a gerenciar chaves de acesso de longo prazo.
Com esse processo, você pode se autenticar usando credenciais raiz criadas durante a configuração inicial da conta, um usuário do IAM ou uma identidade federada do seu provedor de identidade, e o Tools for gerencia PowerShell automaticamente as credenciais temporárias para você. Essa abordagem aprimora a segurança ao eliminar a necessidade de armazenar credenciais de longo prazo localmente.
Ao executar o `Invoke-AWSLogin` cmdlet, você pode selecionar entre suas sessões ativas do console ou entrar por meio do fluxo de autenticação baseado em navegador e isso gerará automaticamente credenciais temporárias. Ferramentas da AWS para PowerShell atualizará automaticamente essas credenciais por até 12 horas.
Depois de configurada, sua sessão pode ser usada em Ferramentas da AWS para PowerShell todas AWS SDKs as outras ferramentas.
### Pré-requisitos
+ Acesso para entrar no AWS Management Console como usuário raiz, usuário do IAM ou por meio de federação com o IAM. Se você usar o Centro de Identidade do IAM, acesse [Configure as ferramentas PowerShell para usar o IAM Identity Center.](#idc-config-sdk) em vez disso.
+ Garanta que a identidade do IAM tenha as permissões apropriadas. Anexe a política [SignInLocalDevelopmentAccess](https://docs.aws.amazon.com/signin/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-SignInLocalDevelopmentAccess)gerenciada ao seu usuário, função ou grupo do IAM. Se você fizer login como usuário-raiz, nenhuma outra permissão será necessária.
### Faça login AWS com o Cmdlet Invoke- AWSLogin
Execute o `Invoke-AWSLogin` cmdlet para autenticar usando suas credenciais existentes do AWS Management Console. Se você não configurou um perfil anteriormente, você será solicitado a fornecer informações adicionais.
Para fazer login ou configurar um perfil, siga as etapas abaixo.
1. Certifique-se de ter importado o módulo correto que você instalou no guia de instalação.
**nota**
Temos três módulos diferentes para PowerShell -`AWS.Tools`, `AWSPowerShell.NetCore` `AWSPowerShell` e. Consulte [O que é o Ferramentas da AWS para PowerShell?](pstools-welcome.md) para obter mais informações.
+ No seu PowerShell terminal, execute o cmdlet. Isso usará o `default` perfil.
```
PS > Invoke-AWSLogin
```
+ Para entrar em um perfil nomeado ou criar um novo, use o `-ProfileName` parâmetro.
```
PS > Invoke-AWSLogin -ProfileName 'my-dev-profile'
```
+ Se esse for um novo perfil ou se nenhum Região da AWS tiver sido especificado ou configurado em qualquer uma das profiles/environment variáveis anteriores, o cmdlet solicitará que você forneça uma região.
```
Press Ctrl+C to cancel the following login prompts.
Specify AWS Region
No AWS region has been configured. The AWS region is the geographic location of your AWS resources.
If you've used AWS before and already have resources in your account, tell us which region they were created in. If you
haven't created resources in your account before, you can pick the region closest to you:
https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html
AWS Region:
```
1. As Ferramentas da AWS para PowerShell tentativas de abrir seu navegador padrão para o processo de login da sua AWS conta.
```
Using region 'us-west-2'
Attempting to open the login page for 'us-west-2' in your default browser.
If the browser does not open, use the following URL to complete your login:
https://signin.us-west-2.amazonaws.com/authorize?
If you cannot connect to this URL, make sure that you have specified a valid region.
```
+ Se o dispositivo usado Ferramentas da AWS para PowerShell não tiver um navegador, você poderá usar o `-Remote` parâmetro para fornecer uma URL para você abrir em um dispositivo habilitado para navegador.
```
PS > Invoke-AWSLogin -Remote
```
+ Se você usou o `-Remote` parâmetro, as instruções para iniciar manualmente o processo de login serão exibidas com base no tipo de autorização que você está usando. O URL exibido é um URL exclusivo que começa com: https://signin.us-east-1.amazonaws.com /authorize. Depois de concluir o login do navegador, você precisará copiar e colar o código de autorização resultante de volta no terminal.
```
Press Ctrl+C to cancel the following login prompts.
Using region 'us-west-2' determined by profile/environment defaults. To override, specify '-Region' parameter.
Please complete the login workflow via the following URL:
https://us-west-2.signin.aws.amazon.com/v1/authorize?
Please enter the authorization code displayed in the browser:
```
1. No navegador, selecione as credenciais a serem usadas na lista exibida e, em seguida, retorne ao seu terminal.
+ Se o perfil que você está configurando tiver uma sessão de login configurada anteriormente que não corresponda à sua nova sessão, ele Ferramentas da AWS para PowerShell solicitará que você confirme que está trocando a sessão que corresponde ao perfil existente.
```
WARNING: Previously profile default was configured for arn:aws:iam::0123456789012:user/ReadOnly,
and is now being updated to arn:aws:iam::0123456789012:user/Admin.
Do you wish to change the identity that default is associated with? (y/n)
```
1. Uma mensagem final descreve a configuração do perfil concluída.
```
Login completed successfully for profile 'my-dev-profile'.
```
O token de autenticação é armazenado em cache no disco sob o. aws/login/cachediretório com um nome de arquivo hash baseado no perfil resolvido.
#### Arquivo de configuração gerado
Essas etapas resultam na criação do perfil padrão ou especificado no arquivo de configuração que se parece com o seguinte:
```
[default]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1
[my-dev-profile]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1
```
#### Executar um comando com seu perfil
Depois de fazer login, você pode usar suas credenciais para invocar o Tools for PowerShell cmdlets com o perfil associado. O exemplo a seguir chama o `Get-STSCallerIdentity` cmdlet usando o perfil padrão:
```
PS > Get-STSCallerIdentity
```
Para verificar uma sessão específica, use o `-ProfileName` parâmetro.
```
PS > Get-STSCallerIdentity -ProfileName 'my-dev-profile'
```
O token de credencial temporário expirará em 15 minutos, mas o Ferramentas da AWS para PowerShell SDKs atualizará automaticamente quando necessário durante suas solicitações. A sessão geral será válida por até 12 horas, após as quais você deverá executar o `Invoke-AWSLogin` cmdlet novamente.
#### Sair da sua sessão usando o `Invoke-AWSLogout` cmdlet
Ao terminar sua sessão, você pode deixar suas credenciais expirarem ou executar o `Invoke-AWSLogout` cmdlet para excluir suas credenciais em cache. Se nenhum perfil for especificado na CLI ou na variável de AWS\$1PROFILE ambiente, o comando desconectará você do seu perfil padrão. O exemplo a seguir desconecta você do seu perfil padrão.
```
PS > Invoke-AWSLogout
```
Para sair de uma sessão de perfil específica, use o `-ProfileName` parâmetro.
```
PS > Invoke-AWSLogout -ProfileName 'my-dev-profile'
```
Para sair de todas as sessões de perfil em que você fez login, use o `-All` parâmetro.
```
PS > Invoke-AWSLogout -All
```
#### Credenciais armazenadas em cache
As credenciais temporárias em cache, bem como os metadados necessários para atualizá-las, são armazenados por padrão `%USERPROFILE%\.aws\login\cache` no Windows ou no `~/.aws/login/cache` Linux e no macOS.
Você pode substituir esse local definindo a variável de `AWS_LOGIN_CACHE_DIRECTORY` ambiente.
## Habilitar e configurar o Centro de Identidade do IAM
Para ser usado Centro de Identidade do AWS IAM, ele deve primeiro ser ativado e configurado. Para ver detalhes sobre como fazer isso PowerShell, consulte a **Etapa 1** no tópico sobre [autenticação do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) no *Guia de referência de ferramentas AWS SDKs e ferramentas*. Especificamente, siga todas as instruções necessárias em **Não estabeleci acesso por meio do Centro de Identidade do IAM**.
## Configure as ferramentas PowerShell para usar o IAM Identity Center.
**nota**
A partir da versão 4.1.538 do Tools for PowerShell, o método recomendado para configurar as credenciais de SSO e iniciar uma sessão do portal de AWS acesso é usar os [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin)cmdlets [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration)e, conforme descrito neste tópico. Se você não tiver acesso a essa versão do Tools for PowerShell (ou posterior) ou não puder usar esses cmdlets, ainda poderá executar essas tarefas usando o. AWS CLI Para saber como, consulte [Use o AWS CLI para login no portal](creds-idc-cli.md).
O procedimento a seguir atualiza o AWS `config` arquivo compartilhado com as informações de SSO que o Tools for PowerShell usa para obter credenciais temporárias. Como consequência desse procedimento, uma sessão do portal de AWS acesso também é iniciada. Se o `config` arquivo compartilhado já tiver informações de SSO e você quiser apenas saber como iniciar uma sessão do portal de acesso usando as Ferramentas para PowerShell, consulte a próxima seção neste tópico,[Iniciar uma sessão do portal de AWS acesso](#idc-start-portal).
1. Se você ainda não tiver feito isso, abra PowerShell e instale o Ferramentas da AWS para PowerShell conforme apropriado para seu sistema operacional e ambiente, incluindo os cmdlets comuns. Para obter informações sobre como fazer isso, consulte [Comece com o Ferramentas da AWS para PowerShell](pstools-getting-set-up.md).
Por exemplo, ao instalar a versão modularizada do Tools for PowerShell no Windows, você provavelmente executaria comandos semelhantes aos seguintes:
```
Install-Module -Name AWS.Tools.Installer
Install-AWSToolsModule AWS.Tools.Common
```
1. Execute o comando a seguir. Substitua os valores de propriedade de exemplo por valores de configuração do Centro de Identidade do IAM. Para obter informações sobre essas propriedades e como encontrá-las, consulte as [configurações do provedor de credenciais do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) no *Guia AWS SDKs de referência de ferramentas*.
```
$params = @{
ProfileName = 'my-sso-profile'
AccountId = '111122223333'
RoleName = 'SamplePermissionSet'
SessionName = 'my-sso-session'
StartUrl = 'https://provided-domain.awsapps.com/start'
SSORegion = 'us-west-2'
RegistrationScopes = 'sso:account:access'
};
Initialize-AWSSSOConfiguration @params
```
Como alternativa, você pode simplesmente usar o cmdlet sozinho e o Tools for PowerShell solicitará os valores da propriedade. `Initialize-AWSSSOConfiguration`
Considerações sobre determinados valores de propriedade:
+ Se você simplesmente seguiu as instruções para [habilitar e configurar o Centro de Identidade do IAM](#idc-config-sso), o valor de `-RoleName` poderá ser `PowerUserAccess`. Mas se você criou um conjunto de permissões do IAM Identity Center especificamente para o PowerShell trabalho, use-o em vez disso.
+ Certifique-se de usar o Região da AWS local em que você configurou o IAM Identity Center.
1. Nesse ponto, o AWS `config` arquivo compartilhado contém um perfil chamado `my-sso-profile` com um conjunto de valores de configuração que podem ser referenciados nas Ferramentas para PowerShell. Para encontrar a localização desse arquivo, consulte [Localização dos arquivos compartilhados no](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Guia de referência de ferramentas AWS SDKs e ferramentas*.
O Tools for PowerShell usa o provedor de token SSO do perfil para adquirir credenciais antes de enviar solicitações para. AWS O `sso_role_name` valor, que é uma função do IAM conectada a um conjunto de permissões do IAM Identity Center, deve permitir o acesso ao Serviços da AWS usado em seu aplicativo.
O exemplo a seguir mostra o perfil que foi criado usando o comando mostrado acima. Alguns dos valores de propriedade e a ordem podem ser diferentes no perfil real. A `sso-session` propriedade do perfil se refere à seção chamada`my-sso-session`, que contém configurações para iniciar uma sessão do portal de AWS acesso.
```
[profile my-sso-profile]
sso_account_id=111122223333
sso_role_name=SamplePermissionSet
sso_session=my-sso-session
[sso-session my-sso-session]
sso_region=us-west-2
sso_registration_scopes=sso:account:access
sso_start_url=https://provided-domain.awsapps.com/start/
```
1. Se você já tiver uma sessão ativa do portal de AWS acesso, as Ferramentas para PowerShell informam que você já está logado.
Se não for esse o caso, use as Ferramentas para PowerShell tentar abrir automaticamente a página de autorização de SSO em seu navegador padrão. Siga as instruções no seu navegador, que podem incluir um código de autorização de SSO, nome de usuário e senha, além de permissão para acessar Centro de Identidade do AWS IAM contas e conjuntos de permissões.
O Tools for PowerShell informa que o login com SSO foi bem-sucedido.
## Iniciar uma sessão do portal de AWS acesso
Antes de executar os comandos que acessam Serviços da AWS, você precisa de uma sessão ativa do portal de AWS acesso para que o Tools for PowerShell possa usar a autenticação do IAM Identity Center para resolver as credenciais. Para entrar no portal de AWS acesso, execute o seguinte comando em PowerShell, onde `-ProfileName my-sso-profile` está o nome do perfil que foi criado no `config` arquivo compartilhado quando você seguiu o procedimento na seção anterior deste tópico.
```
Invoke-AWSSSOLogin -ProfileName my-sso-profile
```
Se você já tiver uma sessão ativa do portal de AWS acesso, as Ferramentas para PowerShell informam que você já está logado.
Se não for esse o caso, use as Ferramentas para PowerShell tentar abrir automaticamente a página de autorização de SSO em seu navegador padrão. Siga as instruções no seu navegador, que podem incluir um código de autorização de SSO, nome de usuário e senha, além de permissão para acessar Centro de Identidade do AWS IAM contas e conjuntos de permissões.
O Tools for PowerShell informa que o login com SSO foi bem-sucedido.
Para testar se você já tiver uma sessão ativa, execute o seguinte comando depois de instalar ou importar o módulo `AWS.Tools.SecurityToken`, conforme necessário.
```
Get-STSCallerIdentity -ProfileName my-sso-profile
```
A resposta para o cmdlet do `Get-STSCallerIdentity` relata a conta do Centro de Identidade do IAM e o conjunto de permissões configurado no arquivo `config` compartilhado.
## Exemplo
Veja a seguir um exemplo de como usar o IAM Identity Center com as Ferramentas para PowerShell. Ele presume o seguinte:
+ Você habilitou Centro de Identidade do IAM e o configurou conforme descrito anteriormente neste tópico. As propriedades SSO estão no perfil `my-sso-profile`, que foi configurado anteriormente neste tópico.
+ Quando você faz login por meio dos cmdlets `Initialize-AWSSSOConfiguration` ou `Invoke-AWSSSOLogin`, o usuário tem pelo menos permissões de somente leitura para o Amazon S3.
+ Alguns buckets do S3 estão disponíveis para esse usuário visualizar.
Instale ou importe o `AWS.Tools.S3` módulo conforme necessário e, em seguida, use o PowerShell comando a seguir para exibir uma lista dos buckets do S3.
```
Get-S3Bucket -ProfileName my-sso-profile
```
## Mais informações
+ Para obter mais opções de autenticação para o Tools for PowerShell, como o uso de perfis e variáveis de ambiente, consulte o capítulo de [configuração AWS](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) *SDKs e o Guia de referência de ferramentas*.
+ Alguns comandos exigem que uma AWS região seja especificada. Existem várias maneiras de fazer isso, inclusive a opção de cmdlet `-Region`, o perfil `[default]` e a variável de ambiente `AWS_REGION`. Para obter mais informações, consulte [Especifique a AWS região para o Ferramentas da AWS para PowerShell](pstools-installing-specifying-region.md) neste guia e a [AWS região](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) no *AWS SDKs Guia de referência de ferramentas*.
+ Para saber mais sobre as práticas recomendadas, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*.
+ Para criar AWS credenciais de curto prazo, consulte [Credenciais de segurança temporárias](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) no Guia do *usuário do IAM*.
+ Para saber mais sobre outros provedores de credenciais, consulte Provedores de [credenciais padronizados no Guia de](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Referência de *Ferramentas AWS SDKs e Ferramentas*.
**Topics**
+ [Faça login usando as credenciais do console](#login-con-creds)
+ [Habilitar e configurar o Centro de Identidade do IAM](#idc-config-sso)
+ [Configure as ferramentas PowerShell para usar o IAM Identity Center.](#idc-config-sdk)
+ [Iniciar uma sessão do portal de AWS acesso](#idc-start-portal)
+ [Exemplo](#idc-short-example)
+ [Mais informações](#idc-additional-info)
+ [Use o AWS CLI](creds-idc-cli.md)
# Use o AWS CLI para login no portal
A partir da versão 4.1.538 do Tools for PowerShell, o método recomendado para configurar as credenciais de SSO e iniciar uma sessão do portal de AWS acesso é usar os [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin)cmdlets [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration)e, conforme descrito em. [Autenticando o com Ferramentas da AWS para PowerShell AWS](creds-idc.md) Se você não tiver acesso a essa versão do Tools for PowerShell (ou posterior) ou não puder usar esses cmdlets, ainda poderá executar essas tarefas usando o. AWS CLI
## Configure as ferramentas PowerShell para usar o IAM Identity Center por meio do AWS CLI.
Se você ainda não tiver feito isso, certifique-se de [habilitar e configurar o IAM Identity Center](creds-idc.md#idc-config-sso) antes de continuar.
As informações sobre como configurar as ferramentas PowerShell para usar o IAM Identity Center por meio do AWS CLI estão na **Etapa 2** do tópico sobre [autenticação do IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) no *AWS SDKs Guia de referência de ferramentas*. Depois de concluir essa configuração, o sistema deverá conter os seguintes elementos:
+ O AWS CLI, que você usa para iniciar uma sessão do portal de AWS acesso antes de executar seu aplicativo.
+ O AWS `config` arquivo compartilhado que contém um [`[default]`perfil](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) com um conjunto de valores de configuração que podem ser referenciados nas Ferramentas para PowerShell. Para encontrar a localização desse arquivo, consulte [Localização dos arquivos compartilhados no](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Guia de referência de ferramentas AWS SDKs e ferramentas*. O Tools for PowerShell usa o provedor de token SSO do perfil para adquirir credenciais antes de enviar solicitações para. AWS O `sso_role_name` valor, que é uma função do IAM conectada a um conjunto de permissões do IAM Identity Center, deve permitir o acesso ao Serviços da AWS usado em seu aplicativo.
O `config` arquivo de exemplo a seguir mostra um `[default]` perfil configurado com um provedor de token SSO. A configuração `sso_session` do perfil se refere à seção chamada `sso-session`. A `sso-session` seção contém configurações para iniciar uma sessão do portal de AWS acesso.
```
[default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access
```
**Importante**
Sua PowerShell sessão deve ter os seguintes módulos instalados e importados para que a resolução de SSO funcione:
`AWS.Tools.SSO`
`AWS.Tools.SSOOIDC`
Se você estiver usando uma versão mais antiga do Tools for PowerShell e não tiver esses módulos, receberá um erro semelhante ao seguinte: “Assembly AWSSDK .SSOOIDC could not be found...”.
## Iniciar uma sessão do portal de AWS acesso
Antes de executar os comandos que acessam Serviços da AWS, você precisa de uma sessão ativa do portal de AWS acesso para que as Ferramentas para Windows PowerShell possam usar a autenticação do IAM Identity Center para resolver as credenciais. Dependendo da duração da sessão configurada, seu acesso acabará expirando e o Tools for Windows PowerShell encontrará um erro de autenticação. Para entrar no portal de AWS acesso, execute o seguinte comando no AWS CLI.
```
aws sso login
```
Como você está usando o `[default]` perfil, não precisa chamar o comando com a `--profile` opção. Se a configuração do seu provedor de token SSO estiver usando um perfil nomeado, o comando estará `aws sso login --profile named-profile` em vez disso. Para obter mais informações sobre perfis nomeados, consulte a seção [Perfis](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) no *Guia de referência de ferramentas AWS SDKs e ferramentas*.
Para testar se você já tem uma sessão ativa, execute o seguinte AWS CLI comando (com a mesma consideração para o perfil nomeado):
```
aws sts get-caller-identity
```
A resposta a esse comando deve relatar a conta do Centro de Identidade do IAM e o conjunto de permissões configurados no arquivo compartilhado `config`.
**nota**
Se você já tiver uma sessão ativa do portal de AWS acesso e executá-la`aws sso login`, não será necessário fornecer credenciais.
O processo de login pode solicitar que você permita o AWS CLI acesso aos seus dados. Como o AWS CLI é construído sobre o SDK para Python, as mensagens de permissão podem conter variações do `botocore` nome.
## Exemplo
Veja a seguir um exemplo de como usar o IAM Identity Center com as Ferramentas para PowerShell. Ele presume o seguinte:
+ Você habilitou Centro de Identidade do IAM e o configurou conforme descrito anteriormente neste tópico. As propriedades de SSO estão no perfil `[default]`.
+ Quando você faz login por meio do AWS CLI usando`aws sso login`, esse usuário tem pelo menos permissões de somente leitura para o Amazon S3.
+ Alguns buckets do S3 estão disponíveis para esse usuário visualizar.
Use os PowerShell comandos a seguir para exibir uma lista dos buckets do S3:
```
Install-Module AWS.Tools.Installer
Install-AWSToolsModule S3
# And if using an older version of the AWS Tools for PowerShell:
Install-AWSToolsModule SSO, SSOOIDC
# In older versions of the AWS Tools for PowerShell, we're not invoking a cmdlet from these modules directly,
# so we must import them explicitly:
Import-Module AWS.Tools.SSO
Import-Module AWS.Tools.SSOOIDC
# Older versions of the AWS Tools for PowerShell don't support the SSO login flow, so login with the CLI
aws sso login
# Now we can invoke cmdlets using the SSO profile
Get-S3Bucket
```
Conforme mencionado acima, como você está usando o `[default]` perfil, não precisa chamar o `Get-S3Bucket` cmdlet com a `-ProfileName` opção. Se a configuração do provedor de token de SSO estiver usando um perfil nomeado, o comando será `Get-S3Bucket -ProfileName named-profile`. Para obter mais informações sobre perfis nomeados, consulte a seção [Perfis](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) no *Guia de referência de ferramentas AWS SDKs e ferramentas*.
## Mais informações
+ Para obter mais opções de autenticação para o Tools for PowerShell, como o uso de perfis e variáveis de ambiente, consulte o capítulo de [configuração AWS](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) *SDKs e o Guia de referência de ferramentas*.
+ Alguns comandos exigem que uma AWS região seja especificada. Há várias maneiras de fazer isso, incluindo a opção de `-Region` cmdlet, o `[default]` perfil e a variável de `AWS_REGION` ambiente. Para obter mais informações, consulte [Especifique a AWS região para o Ferramentas da AWS para PowerShell](pstools-installing-specifying-region.md) neste guia e a [AWS região](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) no *AWS SDKs Guia de referência de ferramentas*.
+ Para saber mais sobre as práticas recomendadas, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*.
+ Para criar AWS credenciais de curto prazo, consulte [Credenciais de segurança temporárias](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) no Guia do *usuário do IAM*.
+ Para saber mais sobre outros provedores de credenciais, consulte Provedores de [credenciais padronizados no Guia de](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Referência de *Ferramentas AWS SDKs e Ferramentas*.