Ejemplos de Soporte con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

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.

Ejemplos de Soporte con las Herramientas para PowerShell V4

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V4 con Soporte.

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.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Add-ASACommunicationToCase.

Herramientas para PowerShell V4

Ejemplo 1: Se añade el cuerpo de una comunicación por correo electrónico al caso especificado.

Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CommunicationBody "Some text about the case"

Ejemplo 2: Se añade el cuerpo de una comunicación por correo electrónico al caso especificado más una o varias direcciones de correo electrónico incluidas en la línea CC del correo electrónico.

Add-ASACommunicationToCase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -CcEmailAddress @("email1@address.com", "email2@address.com") -CommunicationBody "Some text about the case"
  • Para obtener información sobre la API, consulte AddCommunicationToCase en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelven los detalles de todos los casos de soporte.

Get-ASACase

Ejemplo 2: Se devuelven los detalles de todos los casos de soporte desde la fecha y hora especificadas.

Get-ASACase -AfterTime "2013-09-10T03:06Z"

Ejemplo 3: Se devuelven los detalles de los primeros 10 casos de soporte, incluidos los que se han resuelto.

Get-ASACase -MaxResult 10 -IncludeResolvedCases $true

Ejemplo 4: Se devuelven los detalles del único caso de soporte especificado.

Get-ASACase -CaseIdList "case-12345678910-2013-c4c1d2bf33c5cf47"

Ejemplo 5: Se devuelven los detalles de los casos de soporte especificados.

Get-ASACase -CaseIdList @("case-12345678910-2013-c4c1d2bf33c5cf47", "case-18929034710-2011-c4fdeabf33c5cf47")
  • Para obtener información sobre la API, consulte DescribeCases en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelven todas las comunicaciones del caso especificado.

Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"

Ejemplo 2: Se devuelven todas las comunicaciones desde la medianoche (horario UTC) del 1 de enero de 2012 para el caso especificado.

Get-ASACommunication -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47" -AfterTime "2012-01-10T00:00Z"
  • Para obtener información sobre la API, consulte DescribeCommunications en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelven todos los códigos, nombres y categorías de servicio disponibles.

Get-ASAService

Ejemplo 2: Se devuelven el nombre y las categorías del servicio con el código especificado.

Get-ASAService -ServiceCodeList "amazon-cloudfront"

Ejemplo 3: Se devuelven el nombre y las categorías de los códigos de servicio especificados.

Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch")

Ejemplo 4: Se devuelven el nombre y las categorías (en japonés) de los códigos de servicio especificados. Actualmente, se admiten los códigos de idioma inglés (“en”) y japonés (“ja”).

Get-ASAService -ServiceCodeList @("amazon-cloudfront", "amazon-cloudwatch") -Language "ja"
  • Para obtener información sobre la API, consulte DescribeServices en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve la lista de los niveles de gravedad que pueden asignarse a un caso de AWS Support.

Get-ASASeverityLevel

Ejemplo 2: Devuelve la lista de los niveles de gravedad que pueden asignarse a un caso de AWS Support. Los nombres de los niveles se devuelven en japonés.

Get-ASASeverityLevel -Language "ja"
  • Para obtener información sobre la API, consulte DescribeSeverityLevels en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve la colección de comprobaciones de Trusted Advisor. Debe especificar el parámetro Language, que puede aceptar “en” para la salida en inglés o “ja” para la salida en japonés.

Get-ASATrustedAdvisorCheck -Language "en"
  • Para obtener información sobre la API, consulte DescribeTrustedAdvisorChecks en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve el estado actual de las solicitudes de actualización para las comprobaciones especificadas. Se puede utilizar Request-ASATrustedAdvisorCheckRefresh para solicitar que se actualice la información de estado de las comprobaciones.

Get-ASATrustedAdvisorCheckRefreshStatus -CheckId @("checkid1", "checkid2")

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelven los resultados de una comprobación de Trusted Advisor. La lista de comprobaciones de Trusted Advisor que están disponibles se puede obtener con Get-ASATrustedAdvisorChecks. El resultado contiene el estado general de la comprobación, la fecha y hora en la que se ejecutó por última vez y el identificador único de la comprobación específica. Si desea que los resultados se muestren en japonés, añada el parámetro -Language “ja”.

Get-ASATrustedAdvisorCheckResult -CheckId "checkid1"

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

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve el resumen más reciente de la comprobación especificada de Trusted Advisor.

Get-ASATrustedAdvisorCheckSummary -CheckId "checkid1"

Ejemplo 2: Se devuelven los resúmenes más recientes de las comprobaciones especificadas de Trusted Advisor.

Get-ASATrustedAdvisorCheckSummary -CheckId @("checkid1", "checkid2")

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

Herramientas para PowerShell V4

Ejemplo 1: Se crea un nuevo caso en el Centro de soporte de AWS. Los valores de los parámetros -ServiceCode y -CategoryCode se pueden obtener mediante el cmdlet Get-ASAService. El valor del parámetro -SeverityCode se puede obtener mediante el cmdlet Get-ASASeverityLevel. El valor del parámetro -IssueType puede ser “customer-service” o “technical”. Si se completa correctamente, se mostrará el número del caso de AWS Support. Por defecto, el caso se gestiona en inglés, pero si desea hacerlo en japonés, añada el parámetro -Language “ja”. Los parámetros -ServiceCode, -CategoryCode, -Subject y -CommunicationBody son obligatorios.

New-ASACase -ServiceCode "amazon-cloudfront" -CategoryCode "APIs" -SeverityCode "low" -Subject "subject text" -CommunicationBody "description of the case" -CcEmailAddress @("email1@domain.com", "email2@domain.com") -IssueType "technical"
  • Para obtener información sobre la API, consulte CreateCase en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Request-ASATrustedAdvisorCheckRefresh.

Herramientas para PowerShell V4

Ejemplo 1: Se solicita una actualización para la comprobación especificada de Trusted Advisor.

Request-ASATrustedAdvisorCheckRefresh -CheckId "checkid1"
  • Para obtener información sobre la API, consulte RefreshTrustedAdvisorCheck en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Resolve-ASACase.

Herramientas para PowerShell V4

Ejemplo 1: Se devuelve el estado inicial del caso especificado y su estado actual una vez que se completa la llamada para resolverlo.

Resolve-ASACase -CaseId "case-12345678910-2013-c4c1d2bf33c5cf47"
  • Para obtener información sobre la API, consulte ResolveCase en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).