

Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS Cloud9 ejemplos de uso de Tools for V5 PowerShell
<a name="powershell_5_cloud9_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V5 con. AWS Cloud9

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `Get-C9EnvironmentData`
<a name="cloud9_DescribeEnvironments_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Get-C9EnvironmentData`.

**Herramientas para la PowerShell V5**  
**Ejemplo 1: en este ejemplo se obtiene información sobre los entornos de desarrollo de AWS Cloud9 especificados.**  

```
Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX,1980b80e5f584920801c09086667f0EX
```
**Salida:**  

```
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
```
**Ejemplo 2: Este ejemplo obtiene información sobre el estado del ciclo de vida del entorno de desarrollo AWS Cloud9 especificado.**  

```
(Get-C9EnvironmentData -EnvironmentId 685f892f431b45c2b28cb69eadcdb0EX).Lifecycle
```
**Salida:**  

```
FailureResource Reason Status
--------------- ------ ------
                       CREATED
```
+  Para obtener más información sobre la API, consulte [DescribeEnvironments Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). 

### `Get-C9EnvironmentList`
<a name="cloud9_ListEnvironments_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Get-C9EnvironmentList`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: En este ejemplo se obtiene una lista de los identificadores del entorno de desarrollo de AWS Cloud9 disponibles.**  

```
Get-C9EnvironmentList
```
**Salida:**  

```
685f892f431b45c2b28cb69eadcdb0EX
1980b80e5f584920801c09086667f0EX
```
+  Para obtener más información sobre la API, consulte [ListEnvironments Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference* (V5). 

### `Get-C9EnvironmentMembershipList`
<a name="cloud9_DescribeEnvironmentMemberships_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Get-C9EnvironmentMembershipList`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: en este ejemplo se obtiene información sobre los miembros del entorno de desarrollo AWS Cloud9 especificado.**  

```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
**Salida:**  

```
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
```
**Ejemplo 2: Este ejemplo obtiene información sobre el propietario del entorno de desarrollo AWS Cloud9 especificado.**  

```
Get-C9EnvironmentMembershipList -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission owner
```
**Salida:**  

```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : owner
UserArn       : arn:aws:iam::123456789012:user/MyDemoUser
UserId        : AIDAJ3LOROMOUXTBSU6EX
```
**Ejemplo 3: Este ejemplo obtiene información sobre el miembro del entorno especificado para varios entornos de desarrollo de AWS Cloud9.**  

```
Get-C9EnvironmentMembershipList -UserArn arn:aws:iam::123456789012:user/MyDemoUser
```
**Salida:**  

```
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
```
+  Para obtener más información sobre la API, consulte [DescribeEnvironmentMemberships Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). 

### `Get-C9EnvironmentStatus`
<a name="cloud9_DescribeEnvironmentStatus_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Get-C9EnvironmentStatus`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: Este ejemplo obtiene información de estado del entorno de desarrollo AWS Cloud9 especificado.**  

```
Get-C9EnvironmentStatus -EnvironmentId 349c86d4579e4e7298d500ff57a6b2EX
```
**Salida:**  

```
Message                     Status
-------                     ------
Environment is ready to use ready
```
+  Para obtener información sobre la API, consulte [DescribeEnvironmentStatus Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). 

### `New-C9EnvironmentEC2`
<a name="cloud9_CreateEnvironmentEc2_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `New-C9EnvironmentEC2`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: En este ejemplo se crea un entorno de desarrollo AWS Cloud9 con la configuración especificada, se lanza una instancia de Amazon Elastic Compute Cloud (Amazon EC2) y, a continuación, se conecta desde la instancia al entorno.**  

```
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
```
**Salida:**  

```
ffd88420d4824eeeaeaa8a04bfde8cEX
```
+  Para obtener más información sobre la API, consulte la sección [CreateEnvironmentEc2](https://docs.aws.amazon.com/powershell/v5/reference) en la *referencia de Herramientas de AWS para PowerShell cmdlets (V5*). 

### `New-C9EnvironmentMembership`
<a name="cloud9_CreateEnvironmentMembership_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `New-C9EnvironmentMembership`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: Este ejemplo agrega el miembro del entorno especificado al entorno de desarrollo AWS Cloud9 especificado.**  

```
New-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-write
```
**Salida:**  

```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : read-write
UserArn       : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId        : AIDAJ3BA6O2FMJWCWXHEX
```
+  Para obtener más información sobre la API, consulte [CreateEnvironmentMembership Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). 

### `Remove-C9Environment`
<a name="cloud9_DeleteEnvironment_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-C9Environment`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: en este ejemplo se elimina el entorno de desarrollo AWS Cloud9 especificado. Si hay una instancia de Amazon EC2 conectada al entorno, se termina también la instancia.**  

```
Remove-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+  Para obtener más información sobre la API, consulte [DeleteEnvironment Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference* (V5). 

### `Remove-C9EnvironmentMembership`
<a name="cloud9_DeleteEnvironmentMembership_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-C9EnvironmentMembership`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: en este ejemplo se elimina el miembro del entorno de entorno especificado del entorno de desarrollo AWS Cloud9 especificado.**  

```
Remove-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX
```
+  Para obtener más información sobre la API, consulte [DeleteEnvironmentMembership Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference* (V5). 

### `Update-C9Environment`
<a name="cloud9_UpdateEnvironment_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Update-C9Environment`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: Este ejemplo cambia la configuración especificada del entorno de desarrollo AWS Cloud9 existente especificado.**  

```
Update-C9Environment -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Description "My changed demonstration development environment." -Name my-changed-demo-env
```
+  Para obtener más información sobre la API, consulte [UpdateEnvironment Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). 

### `Update-C9EnvironmentMembership`
<a name="cloud9_UpdateEnvironmentMembership_powershell_5_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `Update-C9EnvironmentMembership`.

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: Este ejemplo cambia la configuración del miembro del entorno existente especificado para el entorno de desarrollo AWS Cloud9 especificado.**  

```
Update-C9EnvironmentMembership -UserArn arn:aws:iam::123456789012:user/AnotherDemoUser -EnvironmentId ffd88420d4824eeeaeaa8a04bfde8cEX -Permission read-only
```
**Salida:**  

```
EnvironmentId : ffd88420d4824eeeaeaa8a04bfde8cEX
LastAccess    : 1/1/0001 12:00:00 AM
Permissions   : read-only
UserArn       : arn:aws:iam::123456789012:user/AnotherDemoUser
UserId        : AIDAJ3BA6O2FMJWCWXHEX
```
+  Para obtener más información sobre la API, consulte [UpdateEnvironmentMembership Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). 