Ferramentas da AWS para PowerShell O V4 entrou no modo de manutenção.
Recomendamos que você migre para a [Ferramentas da AWS para PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Para obter detalhes e informações adicionais sobre como migrar, consulte nosso [anúncio do modo de manutenção](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).
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á.
# Trabalhe com AWS serviços no Ferramentas da AWS para PowerShell
Esta seção fornece exemplos de uso do Ferramentas da AWS para PowerShell para acessar AWS serviços. Esses exemplos ajudam a demonstrar como usar os cmdlets para realizar tarefas reais AWS . Esses exemplos se baseiam nos cmdlets fornecidos pelo Tools for PowerShell . Para ver quais cmdlets estão disponíveis, consulte a [Referência do cmdlet do Ferramentas da AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference/).
## PowerShell Codificação de concatenação de arquivos
Alguns cmdlets na Ferramentas da AWS para PowerShell edição de arquivos ou registros existentes que você tem em. AWS Um exemplo é`Edit-R53ResourceRecordSet`, que chama a [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html)API para o Amazon Route 53.
Quando você edita ou concatena arquivos em versões PowerShell 5.1 ou anteriores, 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 em UTF-16, você pode canalizar seu comando para PowerShell o `Out-File` cmdlet 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 AWS CLI comandos de dentro do PowerShell console, o mesmo comportamento se aplica. Você pode canalizar a saída de um AWS CLI comando para `Out-File` o PowerShell console. 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"
```
**nota**
PowerShell 6.0 e versões mais recentes, incluindo o PowerShell Core, retêm automaticamente a codificação UTF-8 para saída de arquivos concatenados.
## Objetos devolvidos para as PowerShell ferramentas
Para ser Ferramentas da AWS para PowerShell mais útil em um PowerShell ambiente nativo, o objeto retornado por um Ferramentas da AWS para PowerShell cmdlet é um objeto.NET, não o objeto de texto JSON que normalmente é retornado da API correspondente no SDK. AWS Por exemplo, `Get-S3Bucket` emite uma coleção `Buckets`, não um objeto de resposta JSON do Amazon S3. A `Buckets` coleção pode ser colocada no PowerShell pipeline e interagida de maneira apropriada. Da mesma forma, `Get-EC2Instance` emite uma coleção de objetos .NET `Reservation`, não um objeto de resultado JSON `DescribeEC2Instances`. Esse comportamento é intencional e permite que a Ferramentas da AWS para PowerShell experiência seja mais consistente com a idiomática PowerShell.
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](pstools-ec2.md)
Esta seção aborda as etapas necessárias para executar uma instância do Amazon EC2, incluindo como:
+ Recupere uma lista de Amazon Machine Images (AMIs).
+ Criar um par de chaves para autenticação SSH.
+ Crie e configure um grupo de segurança do Amazon EC2.
+ Executar a instância e recuperar informações sobre ela.
## [Amazon S3](pstools-s3.md)
A seção aborda as etapas necessárias para criar um site estático hospedado no Amazon S3. Ela demonstra como:
+ Criar e excluir buckets do Amazon S3.
+ Fazer upload de arquivos para um bucket do Amazon S3 na forma de objetos.
+ Excluir objetos de um bucket do Amazon S3.
+ Designar um bucket do Amazon S3 como um site.
## [AWS Lambda and Ferramentas da AWS para PowerShell](pstools-lambda.md)
Esta seção fornece uma breve visão geral das Ferramentas AWS Lambda para o PowerShell módulo e descreve as etapas necessárias para configurar o módulo.
## [Amazon SNS e Amazon SQS](pstools-sqs-queue-sns-topic.md)
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:
+ Crie um tópico do Amazon SNS.
+ Como criar uma fila do Amazon SQS.
+ Inscrever a fila no tópico do .
+ Envie uma mensagem para o tópico.
+ Receba a mensagem da fila.
## [CloudWatch](pstools-cw.md)
Esta seção fornece um exemplo de como publicar dados personalizados para o CloudWatch.
+ Publique uma métrica personalizada em seu CloudWatch painel.
## Consulte também
+ [Conceitos básicos da AWS Tools for Windows PowerShell](pstools-getting-started.md)
## Tópicos
+ [Amazon S3 e Tools for Windows PowerShell](pstools-s3.md)
+ [Amazon EC2 e Tools for Windows PowerShell](pstools-ec2.md)
+ [AWS Lambda and Ferramentas da AWS para PowerShell](pstools-lambda.md)
+ [Amazon SQS, Amazon SNS e ferramentas para Windows PowerShell](pstools-sqs-queue-sns-topic.md)
+ [CloudWatch do AWS Tools for Windows PowerShell](pstools-cw.md)
+ [Usar o parâmetro ClientConfig em cmdlets](pstools-clientconfig.md)