¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del!
Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.
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.
CloudTrail ejemplos de uso de Tools for V4 PowerShell
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 V4 con CloudTrail.
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.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar Find-CTEvent.
- Herramientas para la PowerShell V4
-
Ejemplo 1: Devuelve todos los eventos que se produjeron en los últimos siete días. De forma predeterminada, el cmdlet realiza automáticamente varias llamadas para entregar todos los eventos y termina de ejecutarse cuando el servicio indica que no hay más datos disponibles.
Find-CTEventEjemplo 2: Devuelve todos los eventos que se han producido en los últimos siete días y especifica una región que no es la predeterminada del intérprete de comandos actual.
Find-CTEvent -Region eu-central-1Ejemplo 3: Devuelve todos los eventos asociados a la llamada a la RunInstances API.
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }Ejemplo 4: Devuelve los cinco primeros eventos disponibles.
Find-CTEvent -MaxResult 5-
Para obtener más información sobre la API, consulte LookupEvents Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-CTTrail.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Recupera la configuración de todos los registros de seguimiento asociados a la región actual de su cuenta.
Get-CTTrailEjemplo 2: Devuelve la configuración de todos los registros de seguimiento especificados.
Get-CTTrail -TrailNameList trail1,trail2Ejemplo 3: Devuelve la configuración de todos los registros de seguimiento especificados que se crearon en una región distinta de la predeterminada del intérprete de comandos actual [en este caso, la región de Fráncfort (eu-central-1)].
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1-
Para obtener más información sobre la API, consulte DescribeTrails Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-CTTrailStatus.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Devuelve la información de estado del sendero con el nombre 'myExampleTrail'. Los datos devueltos incluyen información sobre los errores de entrega, los errores de Amazon SNS y Amazon S3 y las horas de inicio y finalización de registro del registro de seguimiento. En este ejemplo se presupone que el registro de seguimiento se creó en la misma región que la predeterminada del intérprete de comandos actual.
Get-CTTrailStatus -Name myExampleTrailEjemplo 2: Devuelve la información de estado de un registro de seguimiento que se creó en una región distinta de la predeterminada del intérprete de comandos actual [en este caso, la región de Fráncfort (eu-central-1)].
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1-
Para obtener más información sobre la API, consulte GetTrailStatus Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-CTTrail.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Crea un registro de seguimiento que utilizará el bucket “amzn-s3-demo-bucket” para almacenar los archivos de registro.
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"Ejemplo 2: Crea un registro de seguimiento que utilizará el bucket “amzn-s3-demo-bucket” para almacenar los archivos de registro. Los objetos de S3 que representan los registros tendrán el prefijo de clave común “mylogs”. Cuando se envíen nuevos registros al bucket, se enviará una notificación al tema de SNS “mlog-deliverytopic”. En este ejemplo, se utiliza el método splatting para proporcionar los valores de los parámetros al cmdlet.
$params = @{ Name="awscloudtrail-example" S3BucketName="amzn-s3-demo-bucket" S3KeyPrefix="mylogs" SnsTopicName="mlog-deliverytopic" } New-CTTrail @params-
Para obtener más información sobre la API, consulte CreateTrail Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-CTTrail.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Elimina el registro de seguimiento especificado. Se le pedirá confirmación antes de que se ejecute el comando. Para suprimir la confirmación, añada el parámetro modificador -Force.
Remove-CTTrail -Name "awscloudtrail-example"-
Para obtener más información sobre la API, consulte DeleteTrail Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Start-CTLogging.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Inicia el registro de las llamadas a la AWS API y la entrega del archivo de registro para la ruta denominada 'myExampleTrail'. En este ejemplo se presupone que el registro de seguimiento se creó en la misma región que la predeterminada del intérprete de comandos actual.
Start-CTLogging -Name myExampleTrailEjemplo 2: Inicia el registro de las llamadas a la AWS API y la entrega de archivos de registro para una ruta que se creó en una región distinta de la predeterminada del shell actual (en este caso, la región de Fráncfort (eu-central-1)).
Start-CTLogging -Name myExampleTrail -Region eu-central-1-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet StartLoggingReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-CTLogging.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: suspende la grabación de las llamadas a la AWS API y la entrega de archivos de registro para la ruta denominada 'myExampleTrail'. En este ejemplo se presupone que el registro de seguimiento se creó en la misma región que la predeterminada del intérprete de comandos actual.
Stop-CTLogging -Name myExampleTrailEjemplo 2: suspende el registro de las llamadas a la AWS API y la entrega de archivos de registro para una ruta que se creó en una región distinta de la predeterminada del shell actual (en este caso, la región de Fráncfort (eu-central-1)).
Stop-CTLogging -Name myExampleTrail -Region eu-central-1-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet StopLoggingReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Update-CTTrail.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Actualiza el registro de seguimiento especificado para que se registren los eventos de servicio globales (como los de IAM) y cambia el prefijo de clave común de los archivos de registro para que en el futuro sea “globallogs”.
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"Ejemplo 2: Actualiza el registro de seguimiento especificado para que las notificaciones sobre las nuevas entregas de registros se envíen al tema de SNS especificado.
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"Ejemplo 3: Actualiza el registro de seguimiento especificado para que los registros se entreguen a un bucket diferente.
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"-
Para obtener más información sobre la API, consulte UpdateTrail Herramientas de AWS para PowerShellCmdlet Reference (V4).
-