Instalar AWS.Tools en Linux o macOS (recomendado) - Herramientas de AWS para PowerShell (versión 5)
Ejecución de scriptsInicialice la sesión PowerShell Control de versionesActualización del Herramientas de AWS para PowerShell en Linux o macOSInformación relacionada

¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del!

Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema sobre migración.

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.

Instalar AWS.Tools en Linux o macOS (recomendado)

Para obtener información general Herramientas de AWS para PowerShell sobre la instalación en Linux o macOS, incluidos los requisitos previos y otras opciones, consulte el tema principal.

Para obtener información sobre las herramientas PowerShell que vienen preinstaladas en AWS CloudShell, consulte. Instalado en CloudShell

Puede instalar la versión modularizada de Herramientas de AWS para PowerShell en equipos que ejecuten PowerShell Core 6.0 o una versión 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 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 uno de los directorios del módulo. Para saber cuáles son los directorios del módulo, puede imprimir el valor de la variable $Env:PSModulePath.

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

Para instalar AWS.Tools en Linux o macOS mediante el AWS.Tools.Installer módulo

  1. Inicie una sesión PowerShell básica ejecutando el siguiente comando.

    $ pwsh
    nota

    Te recomendamos que no te postules 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 varios módulos de AWS.Tools con el módulo AWS.Tools.Installer, 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 se te notifica que el repositorio «no es de confianza», se te preguntará si deseas instalarlo de todos modos. Introduzca y para PowerShell permitir la instalación del módulo. Para evitar que aparezca el mensaje e instalar el módulo sin confiar en el repositorio, puede ejecutar el siguiente comando.

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

  3. Ahora puede instalar el módulo para cada servicio que desee utilizar. Por ejemplo, el siguiente comando instala los módulos 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. Es un módulo compartido que todos los módulos de servicio de AWS necesitan. 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 Install-AWSToolsModule cmdlet descarga todos los módulos solicitados del PSRepository nombre PSGallery (https://www.powershellgallery.com/) y considera el repositorio como una fuente de confianza. Utilice el comando Get-PSRepository -Name PSGallery para obtener más información sobre este repositorio de PSRepository.

    El comando anterior instala los módulos en los directorios predeterminados del sistema. Los directorios reales dependen de la distribución y la versión del sistema operativo y de la versión PowerShell que haya instalado. Por ejemplo, si instaló PowerShell 7 en un sistema similar a RHEL, lo más probable es que los módulos predeterminados estén ubicados en /opt/microsoft/powershell/7/Modules (o$PSHOME/Modules) y los módulos de usuario probablemente estén ubicados en. ~/.local/share/powershell/Modules Para obtener más información, consulte Instalar PowerShell en Linux en el PowerShell sitio web de Microsoft. Para ver dónde están instalados los módulos, ejecute el siguiente comando:

    PS > Get-Module -ListAvailable

    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.

Ejecución de scripts

El comando Set-ExecutionPolicy no está disponible en los sistemas que no son Windows. Puede ejecutarGet-ExecutionPolicy, lo que demuestra que la configuración de política de ejecución predeterminada en PowerShell Core que se ejecuta en sistemas que no son Windows esUnrestricted. Para obtener más información, vea Acerca de las directivas de ejecución en el sitio web de Microsoft Technet.

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

AWS.Tools

PS > Get-Module -ListAvailable

    Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version    Name                                PSEdition ExportedCommands
---------- -------    ----                                --------- ----------------
Binary     3.3.563.1  AWS.Tools.Common                    Desk      {Clear-AWSHistory, Set-AWSHistoryConfiguration, Initialize-AWSDefaultConfiguration, Clear-AWSDefaultConfigurat…

Inicialice la sesión PowerShell

Cuando inicie PowerShell en un sistema basado en Linux o macOS después de haber instalado el Herramientas de AWS para PowerShell, debe ejecutar Initialize- AWSDefault Configuration para especificar qué clave de acceso usar. AWS Para obtener más información acerca de Initialize-AWSDefaultConfiguration, consulte Uso de AWS credenciales.

nota

En versiones anteriores (anteriores a la 3.3.96.0) del, este cmdlet recibía el nombre. Herramientas de AWS para PowerShellInitialize-AWSDefaults

Control de versiones

AWS publica nuevas versiones del Herramientas de AWS para PowerShell periódicamente para admitir nuevos servicios y características. AWS Para determinar la versión Herramientas de AWS para PowerShell que ha instalado, ejecute el AWSPower ShellVersion cmdlet Get-.

Por ejemplo:

PS > Get-AWSPowerShellVersion

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

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

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/main/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]

Para ver una lista de los AWS servicios compatibles en la versión actual de las herramientas, agregue el -ListServiceVersionInfo parámetro a un cmdlet Get- AWSPower ShellVersion.

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

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 del Herramientas de AWS para PowerShell en Linux o macOS

Periódicamente, a medida que Herramientas de AWS para 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 AWS.Tools módulos actualmente instalados y, tras una actualización correcta, elimina las versiones anteriores.

nota

El Update-AWSToolsModule cmdlet descarga todos los módulos del PSRepository nombre PSGallery (https://www.powershellgallery.com/) y lo considera una fuente de confianza. Use el Get-PSRepository -Name PSGallery comando para obtener más información al respecto. PSRepository

Información relacionada