PowerShell 文件联接编码 PowerShell 工具的返回对象 Amazon EC2 Amazon S3 Amazon Lambda 和 Amazon Tools for PowerShell Amazon SNS 和 Amazon SQS CloudWatch 另请参阅主题

在 Amazon Tools for PowerShell 中使用 Amazon 服务

本节提供使用 Amazon Tools for PowerShell 访问Amazon服务的示例。这些示例帮助说明如何使用 cmdlet 执行实际的Amazon任务。这些示例依赖于 Tools for PowerShell 提供的 cmdlet。要查看有哪些 cmdlet 可用，请参阅 Amazon Tools for PowerShell Cmdlet 参考。

PowerShell 文件联接编码

Amazon Tools for PowerShell 中的一些 cmdlet 编辑您目前在 Amazon 中拥有的文件或记录。例如 Edit-R53ResourceRecordSet，它对 Amazon Route 53 调用 ChangeResourceRecordSets API。

在 PowerShell 5.1 或更早版本中编辑或联接文件时，PowerShell 会以 UTF-16（而不是 UTF-8）格式对输出进行编码。这可能会添加不需要的字符并创建无效的结果。十六进制编辑器可以显示不需要的字符。

要避免将文件输出转换为 UTF-16，您可以将命令传递到 PowerShell 的 Out-File cmdlet 中并指定 UTF-8 编码，如以下示例所示：


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

如果您在 PowerShell 控制台中运行 Amazon CLI 命令，则相同的行为将适用。您可以将 Amazon CLI 命令的输出传递到 PowerShell 控制台中的 Out-File。其他 cmdlet（例如 Export-Csv 或 Export-Clixml）也具有 Encoding 参数。有关具有 Encoding 参数并允许您纠正联接文件输出的编码的 cmdlet 的完整列表，请运行以下命令：


PS > Get-Command -ParameterName "Encoding"

注意

PowerShell 6.0 及更高版本（包括 PowerShell Core）会自动为联接的文件输出保留 UTF-8 编码。

PowerShell 工具的返回对象

为了使 Amazon Tools for PowerShell 在本机 PowerShell 环境中发挥更大作用，Amazon Tools for PowerShell cmdlet 返回的对象是一个 .NET 对象，而不是通常从 Amazon 开发工具包中的相应 API 返回的 JSON 文本对象。例如，Get-S3Bucket 发出 Buckets 集合，而不是 Amazon S3 JSON 响应对象。Buckets 集合可以放置在 PowerShell 管道中，并以适当的方式交互。同样，Get-EC2Instance 发出一个 Reservation .NET 对象集合，而不是 DescribeEC2Instances JSON 结果对象。此行为是设计使然，以使 Amazon Tools for PowerShell 体验与惯用的 PowerShell 更加一致。

如果您需要，您可以使用实际的服务响应。它们作为 note 属性存储在返回的对象上。对于使用 NextToken 字段支持分页的 API 操作，这些还可作为 note 属性附加。