La Herramientas de AWS para PowerShell versión 5 (V5) está en versión preliminar. Para ver el contenido de la versión 5, que está sujeto a cambios, y probar la nueva versión, consulta la guía del usuario de la versión 5 (versión preliminar). Para obtener información específica sobre los cambios más importantes y la migración a la V5, consulta el tema sobre migración de esa guía.

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

En este tema se proporcionan instrucciones sobre cómo instalarlo Herramientas de AWS para PowerShell en Linux o macOS.

Información general de la configuración

Para instalarlo Herramientas de AWS para PowerShell en un ordenador Linux o macOS, puede elegir entre dos opciones de paquetes:

La configuración de cualquiera de estas versiones en un equipo con Linux o macOS implica las siguientes tareas, que se describen en detalle más adelante en este tema:

Requisitos previos

Para ejecutarlo AWS Tools for PowerShell Core, su equipo debe ejecutar PowerShell Core 6.0 o una versión posterior.

Instalación de AWS.Tools en Linux o macOS

Puede instalar la versión modularizada de Herramientas de AWS para PowerShell en ordenadores 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:

Instale AWSPower Shell. NetCore en Linux o macOS

Para actualizar a una versión más reciente de AWSPower Shell. NetCore, siga las instrucciones que se indican enActualización del Herramientas de AWS para PowerShell en Linux o macOS. Desinstale las versiones anteriores de AWSPower Shell. NetCore primero.

Puede instalar AWSPower Shell. NetCore de dos maneras:

Para instalar AWSPower Shell. NetCore en Linux o macOS mediante el cmdlet Install-Module

Inicie una sesión de PowerShell Core ejecutando el siguiente comando.

$ pwsh

Para instalar el AWSPower Shell. NetCore paquete de un solo módulo de la PowerShell Galería, ejecute el siguiente comando.

PS > Install-Module -Name AWSPowerShell.NetCore

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 le notifica 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 que aparezca el mensaje que indica que el repositorio no es de confianza, puede ejecutar el siguiente comando.

PS > Install-Module -Name AWSPowerShell.NetCore -Force

No tiene que ejecutar este comando como root, a menos que desee instalarlo Herramientas de AWS para PowerShell para todos los usuarios de un equipo. Para ello, ejecute el siguiente comando en una PowerShell sesión con la que haya empezadosudo pwsh.

PS > Install-Module -Scope AllUsers -Name AWSPowerShell.NetCore -Force

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…

AWSPowerConcha. NetCore

PS > Get-Module -ListAvailable

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

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Binary     3.3.563.1  AWSPowerShell.NetCore

Configure una PowerShell consola para usar el AWS Tools for PowerShell Core (AWSPowerShell). NetCore (Solo)

PowerShell Por lo general, Core carga los módulos automáticamente cada vez que se ejecuta un cmdlet en el módulo. Pero esto no funciona para AWSPower Shell. NetCore debido a su gran tamaño. Para empezar a ejecutar AWSPower Shell. NetCore cmdlets, primero debe ejecutar el Import-Module AWSPowerShell.NetCore comando. Esto no es necesario en los cmdlets de los módulos AWS.Tools.

Inicialice su 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.

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 4.1.675
Copyright 2012-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NET
Core Runtime Version 3.7.400.33
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]

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, debes actualizar la versión que estás 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 hay instalados actualmente y, en los módulos que se actualizaron correctamente, elimina las versiones anteriores.

Actualice las herramientas para Core PowerShell

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 AWSPower Shell. 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 .

Información relacionada