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

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Trabalhar com serviços da AWS no Ferramentas da AWS para PowerShell

Esta seção fornece exemplos de uso do Ferramentas da AWS para PowerShell para acessar serviços da AWS. Esses exemplos ajudam a demonstrar como usar os cmdlets para executar tarefas da AWS reais. Esses exemplos se baseiam nos cmdlets fornecidos pelas Ferramentas para PowerShell. Para ver quais cmdlets estão disponíveis, consulte a Referência do cmdlet do Ferramentas da AWS para PowerShell.

Codificação de concatenação de arquivo do PowerShell

Alguns cmdlets no Ferramentas da AWS para PowerShell editam os arquivos ou registros existentes que você tem na AWS. Um exemplo é Edit-R53ResourceRecordSet, que chama a API ChangeResourceRecordSets para o Amazon Route 53.

Quando você edita ou concatena arquivos no PowerShell 5.1 ou versões anteriores, o PowerShell codifica a saída em UTF-16, não em UTF-8. Isso pode adicionar caracteres indesejados e criar resultados que não são válidos. Um editor hexadecimal pode revelar os caracteres indesejados.

Para evitar a conversão da saída do arquivo para UTF-16, é possível redirecionar seu comando para o cmdlet Out-File do PowerShell e especificar a codificação UTF-8, conforme mostrado no exemplo a seguir:

PS > *some file concatenation command* | Out-File filename.txt -Encoding utf8

Se você estiver executando comandos da AWS CLI no console do PowerShell, o mesmo comportamento se aplicará. É possível redirecionar a saída de um comando da AWS CLI para Out-File no console do PowerShell. Outros cmdlets, como o Export-Csv ou o Export-Clixml, também têm um parâmetro Encoding. Para obter uma lista completa de cmdlets que tenham um parâmetro Encoding e que permitam que você corrija a codificação da saída de um arquivo concatenado, execute o comando a seguir:

PS > Get-Command -ParameterName "Encoding"

Objetos retornados para as ferramentas do Powershell

Para tornar o Ferramentas da AWS para PowerShell mais útil em um ambiente nativo do PowerShell, o objeto retornado por um cmdlet do Ferramentas da AWS para PowerShell é um objeto.NET, não o objeto de texto JSON que normalmente é retornado da API correspondente no AWS SDK. Por exemplo, Get-S3Bucket emite uma coleção Buckets, não um objeto de resposta JSON do Amazon S3. A coleção Buckets pode ser colocada no pipeline do PowerShell e é possível interagir com ela de maneiras apropriadas. Da mesma forma, Get-EC2Instance emite uma coleção de objetos .NET Reservation, não um objeto de resultado JSON DescribeEC2Instances. Esse comportamento é por design e permite que a experiência do Ferramentas da AWS para PowerShell seja mais consistente com o PowerShell idiomático.

As respostas do serviço real estão disponíveis se você precisar delas. Elas são armazenadas como propriedades note nos objetos retornados. Para ações de API que ofereçam suporte à paginação usando campos NextToken, eles também são anexados como propriedades note.

Amazon EC2

Esta seção aborda as etapas necessárias para executar uma instância do Amazon EC2, incluindo como:

Amazon S3

A seção aborda as etapas necessárias para criar um site estático hospedado no Amazon S3. Ela demonstra como:

AWS Lambda e Ferramentas da AWS para PowerShell

Esta seção fornece uma breve visão geral do módulo AWS Lambda Tools for PowerShell e descreve as etapas necessárias para configurar o módulo.

Amazon SNS e Amazon SQS

Esta seção aborda as etapas necessárias para inscrever uma fila do Amazon SQS em um tópico do Amazon SNS. Ela demonstra como:

CloudWatch

Esta seção fornece um exemplo de como publicar dados personalizados no CloudWatch.

Consulte também

Tópicos