¡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.

Instalación del Herramientas de AWS para PowerShell en Windows

Un equipo basado en Windows puede ejecutar cualquiera de las opciones de paquete las Herramientas de AWS para PowerShell:

El paquete que elija depende de la versión y edición de Windows que esté ejecutando.

La configuración de las Herramientas de AWS para PowerShell implica las siguientes tareas generales, descritas en detalle en este tema.

Requisitos previos

Las versiones más recientes de PowerShell, como PowerShell Core, pueden descargarse de Microsoft en la página Instalación de distintas versiones de PowerShell del sitio web de Microsoft.

Instalación de AWS.Tools en Windows.

La versión por módulos de Herramientas de AWS para PowerShell se puede instalar en equipos que ejecuten Windows con Windows PowerShell versión 5.1 o PowerShell Core 6.0 y versiones posteriores. Para obtener información acerca de cómo instalar PowerShell Core, consulte Instalación de distintas versiones de PowerShell en el sitio web de Microsoft.

Puede instalar AWS.Tools de tres maneras:

Instalar AWSPowerShell.NetCore en Windows

Puede instalar AWSPowerShell.NetCore en equipos que ejecuten Windows con PowerShell versión 3 a 5.1 o PowerShell Core 6.0 o versiones posteriores. Para obtener información acerca de cómo instalar PowerShell Core, consulte Instalación de distintas versiones de PowerShell en el sitio web de Microsoft PowerShell.

Puede instalar AWSPowerShell.NetCore de dos maneras:

Para instalar AWSPowerShell.NetCore desde la Galería de PowerShell con el cmdlet Install-Module

Para instalar AWSPowerShell.NetCore desde la Galería de Powershell, el equipo debe ejecutar PowerShell 5.0 (o una versión posterior) o ejecutar PowerShellGet en PowerShell 3 (o una versión posterior). Ejecute el siguiente comando.

PS > Install-Module -name AWSPowerShell.NetCore

Si ejecuta PowerShell como administrador, el comando anterior instala las Herramientas de AWS para PowerShell para todos los usuarios del equipo. Si ejecuta PowerShell como usuario estándar sin permisos de administrador, ese mismo comando se instala solo las Herramientas de AWS para PowerShell para el usuario actual.

Para realizar la instalación solo para el usuario actual cuando ese usuario tiene permisos de administrador, ejecute el comando con el conjunto de parámetros -Scope CurrentUser, como se indica a continuación.

PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser

Aunque PowerShell 3.0 y las versiones posteriores por lo general cargan los módulos en la sesión de PowerShell la primera vez que se ejecuta un cmdlet en el módulo, el módulo de AWSPowerShell.NetCore es demasiado grande para admitir esta funcionalidad. En su lugar, debe cargar de forma explícita el módulo AWSPowerShell.NetCore Core en la sesión de PowerShell ejecutando el siguiente comando.

PS > Import-Module AWSPowerShell.NetCore

Para cargar el módulo AWSPowerShell.NetCore en una sesión de PowerShell de forma automática, agregue ese comando a su perfil de PowerShell. Para obtener más información sobre cómo editar su perfil de PowerShell, consulte About Profiles en la documentación de PowerShell.

Instalación de AWSPowerShell en Windows PowerShell

Puede instalar AWS Tools for Windows PowerShell de dos maneras:

Para instalar AWSPowerShell desde la Galería de PowerShell con el cmdlet Install-Module

Para instalar AWSPowerShell desde la Galería de PowerShell, es necesario ejecutar PowerShell 5.0 (o una versión posterior) o tener instalado PowerShellGet en PowerShell 3 (o una versión posterior). Puede instalar y actualizar AWSPowerShell desde la Galería de PowerShell de Microsoft ejecutando el siguiente comando.

 PS > Install-Module -Name AWSPowerShell

Para cargar el módulo AWSPowerShell en una sesión de PowerShell de forma automática, agregue el cmdlet import-module anterior al perfil de PowerShell. Para obtener más información sobre cómo editar su perfil de PowerShell, consulte About Profiles en la documentación de PowerShell.

Habilitar la ejecución de scripts

Para cargar los módulos de las Herramientas de AWS para PowerShell, debe habilitar la ejecución de scripts de PowerShell. Para habilitar la ejecución de scripts, ejecute el cmdlet Set-ExecutionPolicy para definir la política RemoteSigned. Para obtener más información, vea Acerca de las directivas de ejecución en el sitio web de Microsoft Technet.

Para habilitar la ejecución de scripts

Si no tiene la política de ejecución establecida correctamente, PowerShell muestra el siguiente error cada vez que intenta ejecutar un script, como su perfil.

File C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 cannot be loaded because the execution
 of scripts is disabled on this system. Please see "get-help about_signing" for more details.
At line:1 char:2
+ . <<<<  'C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1'
    + CategoryInfo          : NotSpecified: (:) [], PSSecurityException
    + FullyQualifiedErrorId : RuntimeException

El instalador de las Tools for Windows PowerShell actualiza PSModulePath de forma automática para incluir la ubicación del directorio que contiene el módulo AWSPowerShell.

Como PSModulePath incluye la ubicación del directorio del módulo de AWS, el cmdlet Get-Module -ListAvailable muestra el módulo.

PS > Get-Module -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   AppLocker                 {}
Manifest   BitsTransfer              {}
Manifest   PSDiagnostics             {}
Manifest   TroubleshootingPack       {}
Manifest   AWSPowerShell             {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...

Control de versiones

AWS publica periódicamente nuevas versiones de las Herramientas de AWS para PowerShell que admiten nuevos servicios y características de AWS. Para saber cuál es la versión de Tools que ha instalado, ejecute el cmdlet Get-AWSPowerShellVersion.

Por ejemplo:

PS > Get-AWSPowerShellVersion

AWS Tools for PowerShell
Version 4.1.849
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NET
Core Runtime Version 3.7.402.75
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/v4.1/changelogs/CHANGELOG.ALL.md

This software includes third party software subject to the following copyrights:
- Logging from log4net, Apache License
[http://logging.apache.org/log4net/license.html]

También puede agregar el parámetro -ListServiceVersionInfo a un comando Get-AWSPowerShellVersion para ver una lista de los servicios de AWS admitidos en la versión actual de las herramientas. Si utiliza la opción de módulos de AWS.Tools.*, solo se muestran los módulos que ha importado actualmente.

Por ejemplo:

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
AWS IAM Access Analyzer            IAMAA       AWS.Tools.AccessAnalyzer          3.7.400.33
AWS Account                        ACCT        AWS.Tools.Account                 3.7.400.33
AWS Certificate Manager Private... PCA         AWS.Tools.ACMPCA                  3.7.400.34
AWS Amplify                        AMP         AWS.Tools.Amplify                 3.7.401.28
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.400.33
...

Para determinar la versión de PowerShell que está ejecutando, escriba $PSVersionTable para ver el contenido de la variable automática $PSVersionTable.

Por ejemplo:

PS > $PSVersionTable

Name                           Value
----                           -----
PSVersion                      6.2.2
PSEdition                      Core
GitCommitId                    6.2.2
OS                             Darwin 18.7.0 Darwin Kernel Version 18.7.0: Tue Aug 20 16:57:14 PDT 2019; root:xnu-4903.271.2~2/RELEASE_X86_64
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

Actualización de las Herramientas de AWS para PowerShell en Windows

De forma periódica, cuando se publiquen versiones actualizadas de las Herramientas de AWS para PowerShell, debería actualizar la versión que ejecuta localmente.

Actualización de módulos AWS.Tools modularizados

Para actualizar los módulos AWS.Tools a la versión más reciente, ejecute el siguiente comando:

PS > Update-AWSToolsModule -CleanUp

Este comando actualiza todos los módulos AWS.Tools que están instalados actualmente y, si esta operación se realiza correctamente, elimina otras versiones instaladas.

Actualización de Tools for PowerShell Core

Ejecute el cmdlet Get-AWSPowerShellVersion para determinar la versión que está ejecutando y compárela con la versión de Tools for Windows PowerShell disponible en el sitio web de la Galería de PowerShell. Le sugerimos que revise cada dos o tres semanas. La compatibilidad con nuevos comandos y servicios de AWS solo está disponible después de realizar la actualización a una versión con esa compatibilidad.

Antes de instalar una versión más reciente de AWSPowerShell.NetCore, desinstale el módulo existente. Cierre las sesiones abiertas de PowerShell antes de desinstalar el paquete existente. Ejecute el siguiente comando para desinstalar el paquete.

PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

Cuando se haya completado la desinstalación del paquete, instale el módulo actualizado ejecutando el siguiente comando.

PS > Install-Module -Name AWSPowerShell.NetCore

Después de la instalación, ejecute el comando Import-Module AWSPowerShell.NetCore para cargar los cmdlets actualizados en la sesión de PowerShell.

Actualización de Tools for Windows PowerShell

Ejecute el cmdlet Get-AWSPowerShellVersion para determinar la versión que está ejecutando y compárela con la versión de Tools for Windows PowerShell disponible en el sitio web de la Galería de PowerShell. Le sugerimos que revise cada dos o tres semanas. La compatibilidad con nuevos comandos y servicios de AWS solo está disponible después de realizar la actualización a una versión con esa compatibilidad.

Después de la instalación, ejecute Import-Module AWSPowerShell para cargar los cmdlets actualizados en la sesión de PowerShell. O ejecute la consola de Herramientas de AWS para PowerShell personalizada desde el menú Inicio .