文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS Cloud9 使用适用于 PowerShell V5 的工具的示例
以下代码示例向您展示了如何使用带 AWS Cloud9的 AWS Tools for PowerShell V5 来执行操作和实现常见场景。
*操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
**Topics**
+ [操作](#actions)
## 操作
### `Get-C9EnvironmentData`
以下代码示例演示了如何使用 `Get-C9EnvironmentData`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例获取有关指定 AWS Cloud9 开发环境的信息。**
```
Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX,1980b80e5f584920801c09086667f0EX
```
**输出**：
```
Arn : arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX
Description : Created from CodeStar.
Id : 685f892f431b45c2b28cb69eadcdb0EX
Lifecycle : Amazon.Cloud9.Model.EnvironmentLifecycle
Name : my-demo-ec2-env
OwnerArn : arn:aws:iam::123456789012:user/MyDemoUser
Type : ec2
Arn : arn:aws:cloud9:us-east-1:123456789012:environment:1980b80e5f584920801c09086667f0EX
Description :
Id : 1980b80e5f584920801c09086667f0EX
Lifecycle : Amazon.Cloud9.Model.EnvironmentLifecycle
Name : my-demo-ssh-env
OwnerArn : arn:aws:iam::123456789012:user/MyDemoUser
Type : ssh
```
**示例 2：此示例获取有关指定 AWS Cloud9 开发环境生命周期状态的信息。**
```
(Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX).Lifecycle
```
**输出**：
```
FailureResource Reason Status
--------------- ------ ------
CREATED
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeEnvironments](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Get-C9EnvironmentList`
以下代码示例演示了如何使用 `Get-C9EnvironmentList`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例获取可用的 AWS Cloud9 开发环境标识符列表。**
```
Get-C9EnvironmentList
```
**输出**：
```
685f892f431b45c2b28cb69eadcdb0EX
1980b80e5f584920801c09086667f0EX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ListEnvironments](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Get-C9EnvironmentMembershipList`
以下代码示例演示了如何使用 `Get-C9EnvironmentMembershipList`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例获取有关指定 AWS Cloud9 开发环境的环境成员的信息。**
```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
**输出**：
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-write
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
**示例 2：此示例获取有关指定 AWS Cloud9 开发环境所有者的信息。**
```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission owner
```
**输出**：
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
**示例 3：此示例获取有关多个 AWS Cloud9 开发环境的指定环境成员的信息。**
```
Get-C9EnvironmentMembershipList -UserArn arn:aws:iam::123456789012:user/MyDemoUser
```
**输出**：
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/17/2018 7:48:14 PM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
EnvironmentId : 1980b80e5f584920801c09086667f0EX
LastAccess : 1/16/2018 11:21:24 PM
Permissions : owner
UserArn : arn:aws:iam::123456789012:user/MyDemoUser
UserId : AIDAJ3LOROMOUXTBSU6EX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeEnvironmentMemberships](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Get-C9EnvironmentStatus`
以下代码示例演示了如何使用 `Get-C9EnvironmentStatus`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例获取指定 AWS Cloud9 开发环境的状态信息。**
```
Get-C9EnvironmentStatus -EnvironmentId 349c86d4579e4e7298d500ff57a6b2EX
```
**输出**：
```
Message Status
------- ------
Environment is ready to use ready
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeEnvironmentStatus](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `New-C9EnvironmentEC2`
以下代码示例演示了如何使用 `New-C9EnvironmentEC2`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例使用指定设置创建一个 AWS Cloud9 开发环境，启动亚马逊弹性计算云 (Amazon EC2) 实例，然后从该实例连接到环境。**
```
New-C9EnvironmentEC2 -Name my-demo-env -AutomaticStopTimeMinutes 60 -Description "My demonstration development environment." -InstanceType t2.micro -OwnerArn arn:aws:iam::123456789012:user/MyDemoUser -SubnetId subnet-d43a46EX
```
**输出**：
```
ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) 中的 [CreateEnvironmentEc2](https://docs.aws.amazon.com/powershell/v5/reference)。
### `New-C9EnvironmentMembership`
以下代码示例演示了如何使用 `New-C9EnvironmentMembership`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例将指定的环境成员添加到指定的 AWS Cloud9 开发环境中。**
```
New-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-write
```
**输出**：
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-write
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateEnvironmentMembership](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Remove-C9Environment`
以下代码示例演示了如何使用 `Remove-C9Environment`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例删除了指定的 AWS Cloud9 开发环境。如果一个 Amazon EC2 实例连接到该环境，也会终止该实例。**
```
Remove-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteEnvironment](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Remove-C9EnvironmentMembership`
以下代码示例演示了如何使用 `Remove-C9EnvironmentMembership`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例从指定的 AWS Cloud9 开发环境中删除指定的环境成员。**
```
Remove-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteEnvironmentMembership](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Update-C9Environment`
以下代码示例演示了如何使用 `Update-C9Environment`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例更改了指定现有 AWS Cloud9 开发环境的指定设置。**
```
Update-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Description "My changed demonstration development environment." -Name my-changed-demo-env
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateEnvironment](https://docs.aws.amazon.com/powershell/v5/reference)中的。
### `Update-C9EnvironmentMembership`
以下代码示例演示了如何使用 `Update-C9EnvironmentMembership`。
**适用于 PowerShell V5 的工具**
**示例 1：此示例更改了指定 AWS Cloud9 开发环境的指定现有环境成员的设置。**
```
Update-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-only
```
**输出**：
```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess : 1/1/0001 12:00:00 AM
Permissions : read-only
UserArn : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId : AIDAJ3BA6O2FMJWCWXHEX
```
+ 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateEnvironmentMembership](https://docs.aws.amazon.com/powershell/v5/reference)中的。