Instalación del AWS Tools for PowerShell en Windows - AWS Tools for PowerShell
Requisitos previosInstalar AWS.ToolsInstalar AWSPowerShell. NetCoreInstalar AWSPowerShellHabilitar la ejecución de scriptsControl de versionesActualizando AWS Tools for PowerShell

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 AWS Tools for PowerShell en Windows

Un equipo basado en Windows puede ejecutar cualquiera de las opciones del AWS Tools for PowerShell paquete:

  • AWS.Tools- La versión modularizada de. AWS Tools for PowerShell Cada AWS servicio está respaldado por su propio módulo pequeño e individual, con módulos AWS.Tools.Common de soporte compartidos y. AWS.Tools.Installer

  • AWSPowerShell. NetCore- La versión única de módulos grandes de AWS Tools for PowerShell. Todos los AWS servicios son compatibles con este módulo único y grande.

    nota

    Tenga en cuenta que el módulo individual puede ser demasiado grande para usarlo con funciones de AWS Lambda. En su lugar, utilice la versión modularizada que se muestra arriba.

  • AWSPowerShell: versión de AWS Tools for PowerShell que se compone de un solo módulo heredado de gran tamaño que es específico de Windows. Todos los AWS servicios son compatibles con este módulo único y grande.

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

nota

Las herramientas para Windows PowerShell (AWSPowerShell módulo) se instalan de forma predeterminada en todas las Amazon Machine Images (AMI) basadas en Windows.

La configuración AWS Tools for PowerShell implica las siguientes tareas de alto nivel, que se describen en detalle en este tema.

  1. Instale la opción de AWS Tools for PowerShell paquete adecuada para su entorno.

  2. Compruebe que la ejecución de scripts está habilitada ejecutando el cmdlet Get-ExecutionPolicy.

  3. Importe el AWS Tools for PowerShell módulo a su PowerShell sesión.

Requisitos previos

Las versiones más recientes de PowerShell, incluida PowerShell Core, están disponibles como descargas en Microsoft en Instalación de varias versiones de PowerShell en el sitio web de Microsoft.

Instalación de AWS.Tools en Windows.

Puede instalar la versión modularizada de AWS Tools for PowerShell en equipos que ejecuten Windows con Windows PowerShell 5.1, PowerShell Core 6.0 o posterior. Para obtener información acerca de cómo instalar PowerShell Core, consulte Instalación de varias versiones de PowerShell en el sitio web de Microsoft.

Puede instalar AWS.Tools de tres maneras:

  • Utilizando los cmdlets del módulo AWS.Tools.Installer. Este módulo simplifica la instalación y actualización de otros AWS.Tools módulos. AWS.Tools.Installerrequiere PowerShellGet y descarga e instala automáticamente una versión actualizada del mismo. AWS.Tools.Installermantiene sincronizadas automáticamente las versiones de sus módulos. Al instalar o actualizar a una versión más reciente de un módulo, los cmdlets AWS.Tools.Installer actualizan automáticamente todos los demás AWS.Tools módulos a la misma versión.

    Este método se describe en el procedimiento siguiente.

  • Descargando los módulos de AWS.Tools.zip y extrayéndolos en una de las carpetas del módulo. Puede descubrir cuáles son las carpetas del módulo mostrando el valor de la variable de entorno PSModulePath.

  • Instalar cada módulo de servicio de la PowerShell Galería mediante el Install-Module cmdlet.

Para instalar AWS.Tools en Windows mediante el módulo AWS.Tools.Installer

  1. Iniciar una PowerShell sesión.

    nota

    Le recomendamos que no se postule PowerShell como administrador con permisos elevados, excepto cuando lo exija la tarea en cuestión. Esto puede suponer un riesgo para la seguridad y no se atiene al principio de privilegios mínimos.

  2. Para instalar el paquete de AWS.Tools por módulos, ejecute el siguiente comando.

    PS > Install-Module -Name AWS.Tools.Installer

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure
 you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): y

    Si aparece una notificación en la que se indica que el repositorio no es de confianza, se le preguntará si desea realizar la instalación de todos modos. Introduzca y para PowerShell permitir la instalación del módulo. Para evitar este mensaje e instalar el módulo sin confiar en el repositorio, puede ejecutar el comando con el parámetro -Force.

    PS > Install-Module -Name AWS.Tools.Installer -Force

  3. Ahora puede instalar el módulo para cada AWS servicio que desee usar mediante el Install-AWSToolsModule cmdlet. Por ejemplo, el siguiente comando instala los módulos de Amazon EC2 y Amazon S3. Este comando también instala los módulos dependientes necesarios para que el módulo especificado funcione. Por ejemplo, cuando instala el primer módulo de servicio AWS.Tools, también se instala AWS.Tools.Common. Se trata de un módulo compartido que requieren todos los módulos de AWS servicio. También elimina las versiones anteriores de los módulos y actualiza otros módulos a la misma versión.

    PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp
  Confirm
  Are you sure you want to perform this action?
  Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0".
  [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

  Installing module AWS.Tools.Common version 4.0.0.0
  Installing module AWS.Tools.EC2 version 4.0.0.0
  Installing module AWS.Tools.Glacier version 4.0.0.0
  Installing module AWS.Tools.S3 version 4.0.0.0

  Uninstalling AWS.Tools version 3.3.618.0
  Uninstalling module AWS.Tools.Glacier
  Uninstalling module AWS.Tools.S3
  Uninstalling module AWS.Tools.SimpleNotificationService
  Uninstalling module AWS.Tools.SQS
  Uninstalling module AWS.Tools.Common
    nota

    El cmdlet Install-AWSToolsModule descarga todos los módulos solicitados desde un repositorio de PSRepository llamado PSGallery (https://www.powershellgallery.com/) y lo considera un origen de confianza. Utilice el comando Get-PSRepository -Name PSGallery para obtener más información sobre este repositorio de PSRepository.

    De forma predeterminada, el comando anterior instala los módulos en la carpeta %USERPROFILE%\Documents\WindowsPowerShell\Modules. Para instalarlo AWS Tools for PowerShell para todos los usuarios de un equipo, debe ejecutar el siguiente comando en una PowerShell sesión que haya iniciado como administrador. Por ejemplo, el siguiente comando instala el módulo de IAM en la carpeta %ProgramFiles%\WindowsPowerShell\Modules que es accesible para todos los usuarios.

    PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers

    Para instalar otros módulos, ejecute comandos similares con los nombres de módulo correspondientes, tal y como se encuentra en la PowerShell Galería.

Instalar AWSPowerShell. NetCore en Windows

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

Puede instalarlo AWSPowerShell. NetCore de dos maneras

  • Descargando el módulo desde AWSPowerShell. NetCore.zip y extrayéndolo en uno de los directorios del módulo. Puede descubrir cuáles son los directorios del módulo mostrando el valor de la variable de entorno PSModulePath.

  • Instalación desde la PowerShell Galería mediante el Install-Module cmdlet, tal y como se describe en el siguiente procedimiento.

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

Para instalar el. AWSPowerShell NetCore desde la PowerShell Galería, su ordenador debe ejecutar la PowerShell versión 5.0 o una versión posterior, o ejecutar PowerShellGetla versión PowerShell 3 o una versión posterior. Ejecute el siguiente comando de la .

PS > Install-Module -name AWSPowerShell.NetCore

Si se ejecuta PowerShell como administrador, el comando anterior se instala AWS Tools for PowerShell para todos los usuarios del equipo. Si se ejecuta PowerShell como usuario estándar sin permisos de administrador, ese mismo comando se instala solo AWS Tools for 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 la PowerShell versión 3.0 y las versiones posteriores suelen cargar módulos en la PowerShell sesión la primera vez que se ejecuta un cmdlet en el módulo, el. AWSPowerShell NetCore el módulo es demasiado grande para admitir esta funcionalidad. En su lugar, debe cargar explícitamente el AWSPowerShell. NetCore Incorpore el módulo principal a su PowerShell sesión ejecutando el siguiente comando.

PS > Import-Module AWSPowerShell.NetCore

Para cargar el AWSPowerShell. NetCore agregue el módulo a una PowerShell sesión automáticamente, añada ese comando a su PowerShell perfil. Para obtener más información sobre cómo editar su PowerShell perfil, consulte Acerca de los perfiles en la PowerShell documentación.

Instálelo AWSPowerShell en Windows PowerShell

Puede instalarlo AWS Tools for Windows PowerShell de dos maneras:

  • Descargando el módulo de AWSPowerShell.zip y extrayéndolo en uno de los directorios del módulo. Puede descubrir cuáles son los directorios del módulo mostrando el valor de la variable de entorno PSModulePath.

  • Instalación desde la PowerShell Galería mediante el Install-Module cmdlet tal y como se describe en el siguiente procedimiento.

Para realizar la instalación AWSPowerShell desde la PowerShell Galería mediante el cmdlet Install-Module

Puede instalarlo AWSPowerShell desde la PowerShell Galería si está ejecutando la PowerShell versión 5.0 o una versión posterior, o si ha instalado PowerShellGetla versión 3 o una versión posterior. PowerShell Puedes instalarlo y actualizarlo AWSPowerShell desde la PowerShellGalería de Microsoft ejecutando el siguiente comando.

 PS > Install-Module -Name AWSPowerShell

Para cargar el AWSPowerShell módulo en una PowerShell sesión automáticamente, añada el import-module cmdlet anterior a su PowerShell perfil. Para obtener más información sobre cómo editar su PowerShell perfil, consulte Acerca de los perfiles en la PowerShell documentación.

nota

Las herramientas para Windows PowerShell se instalan de forma predeterminada en todas las Amazon Machine Images (AMI) basadas en Windows.

Habilitar la ejecución de scripts

Para cargar los AWS Tools for PowerShell módulos, debe habilitar la ejecución de PowerShell scripts. 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.

nota

Este es un requisito solo para equipos que ejecutan Windows. La restricción de seguridad de ExecutionPolicy no está presente en otros sistemas operativos.

Para habilitar la ejecución de scripts

  1. Se requieren derechos de administrador para definir la política de ejecución. Si no ha iniciado sesión como usuario con derechos de administrador, abra una PowerShell sesión como administrador. Elija Inicio y, a continuación, elija Todos los programas. Seleccione Accesorios y, a continuación, Windows PowerShell. Haga clic con el botón derecho en Windows y PowerShell, en el menú contextual, seleccione Ejecutar como administrador.

  2. En el símbolo del sistema, escriba lo siguiente.

    PS > Set-ExecutionPolicy RemoteSigned
nota

En un sistema de 64 bits, debe hacerlo por separado para la versión de 32 bits de PowerShell Windows PowerShell (x86).

Si la política de ejecución no está configurada 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 PowerShell instalador de Tools for Windows actualiza automáticamente el PS ModulePath para incluir la ubicación del directorio que contiene el AWSPowerShell módulo.

Como PSModulePath incluye la ubicación del directorio del AWS módulo, el Get-Module -ListAvailable cmdlet 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 nuevas versiones del AWS Tools for PowerShell periódicamente para admitir nuevos AWS servicios y funciones. Para determinar la versión de las herramientas que ha instalado, ejecute el AWSPowerShellVersion cmdlet Get-.

PS > Get-AWSPowerShellVersion

Tools for PowerShell
Version 4.1.11.0
Copyright 2012-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.

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

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/master/CHANGELOG.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 -ListServiceVersionInfo parámetro a un AWSPowerShellVersion comando Get- para ver una lista de los AWS servicios compatibles con 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.

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
Alexa For Business                 ALXB        AWS.Tools.AlexaForBusiness        3.7.0.11
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.0.11
Amazon API Gateway                 AG          AWS.Tools.APIGateway              3.7.0.11
Amazon API Gateway Management API  AGM         AWS.Tools.ApiGatewayManagementApi 3.7.0.11
Amazon API Gateway V2              AG2         AWS.Tools.ApiGatewayV2            3.7.0.11
Amazon Appflow                     AF          AWS.Tools.Appflow                 3.7.1.4
Amazon Route 53                    R53         AWS.Tools.Route53                 3.7.0.12
Amazon Route 53 Domains            R53D        AWS.Tools.Route53Domains          3.7.0.11
Amazon Route 53 Resolver           R53R        AWS.Tools.Route53Resolver         3.7.1.5
Amazon Simple Storage Service (S3) S3          AWS.Tools.S3                      3.7.0.13
...

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

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

Actualizando el AWS Tools for PowerShell en Windows

Periódicamente, a medida que AWS Tools for PowerShell se publiquen versiones actualizadas del, debe actualizar la versión que está ejecutando localmente.

Actualice los módulos modularizados AWS.Tools

Para actualizar AWS.Tools los módulos a la última versión, 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.

nota

El cmdlet Update-AWSToolsModule descarga todos los módulos de un repositorio de PSRepository llamado PSGallery (https://www.powershellgallery.com/) y considera este repositorio como un origen de confianza. Utilice el comando Get-PSRepository -Name PSGallery para obtener más información sobre este repositorio de PSRepository.

Actualice las herramientas de PowerShell Core

Ejecute el Get-AWSPowerShellVersion cmdlet para determinar la versión que está ejecutando y compárela con la versión de Tools para Windows PowerShell que está disponible en el sitio web de PowerShell Gallery. Le sugerimos que revise cada dos o tres semanas. Support para nuevos comandos y AWS servicios solo está disponible después de actualizar a una versión con ese soporte.

Antes de instalar una versión más reciente de AWSPowerShell. NetCore, desinstale el módulo existente. Cierre todas PowerShell las sesiones abiertas 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

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

Actualice las herramientas para Windows PowerShell

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

  • Si realizó la instalación mediante el cmdlet Install-Module, ejecute los siguientes comandos.

    PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell

  • Si realizó la instalación mediante un archivo ZIP descargado:

    1. Descargue la versión más reciente del sitio PowerShell web Herramientas para. Compare el número de versión del paquete en el nombre del archivo descargado con el número de versión que obtiene cuando se ejecuta el cmdlet Get-AWSPowerShellVersion.

    2. Si el número de la versión de descarga es superior al de la versión que ha instalado, cierre todas las PowerShell consolas de Herramientas para Windows.

    3. Instale la versión más reciente de las Herramientas para Windows PowerShell.

Tras la instalación, ejecútelo Import-Module AWSPowerShell para cargar los cmdlets actualizados en su PowerShell sesión. O bien, ejecute la AWS Tools for PowerShell consola personalizada desde el menú Inicio.