

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

Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema [sobre migración](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).

 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)

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.

# Instale AWSPower Shell. NetCore en Linux o macOS
<a name="install-netcore-on-linux-macos"></a>

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](pstools-getting-set-up-linux-mac.md).

Para obtener información sobre las herramientas PowerShell que vienen preinstaladas en AWS CloudShell, consulte. [Instalado en CloudShell](pstools-getting-set-up-cloudshell.md)

**nota**  
AWSPowerCarcasa. NetCore no es el método recomendado para instalar el Herramientas de AWS para PowerShell. Para ver el método recomendado, consulte [Instalar `AWS.Tools` (recomendado)](install-aws.tools-on-linux-macos.md) en su lugar.

Para actualizar a una versión más reciente de AWSPower Shell. NetCore, siga las instrucciones que se indican en[Actualización del Herramientas de AWS para PowerShell en Linux o macOS](#pstools-updating-linux-netcore). Desinstale las versiones anteriores de AWSPower Shell. NetCore primero.

Puede instalar AWSPower Shell. NetCore de dos maneras:
+ Descargando el módulo de `[AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip)` y extrayéndolo 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`.
+ Instalación desde la PowerShell Galería mediante el `Install-Module` cmdlet tal y como se describe en el siguiente procedimiento.

**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
```

**nota**  
Te recomendamos que *no* empieces PowerShell por correr `sudo pwsh` para correr PowerShell con derechos de administrador elevados. Esto puede suponer un riesgo para la seguridad y no se atiene al principio de privilegios mínimos.

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 instalarlo 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 empezado`sudo pwsh`.

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

## Ejecución de scripts
<a name="enable-script-execution-netcore"></a>

El comando `Set-ExecutionPolicy` no está disponible en los sistemas que no son Windows. Puede ejecutar`Get-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 es`Unrestricted`. Para obtener más información, vea [Acerca de las directivas de ejecución](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1) 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.

**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)
<a name="pstools-config-ps-window-netcore"></a>

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
<a name="linux-config-init-netcore"></a>

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](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) para especificar qué clave de acceso usar. AWS Para obtener más información acerca de `Initialize-AWSDefaultConfiguration`, consulte [Uso de AWS credenciales](specifying-your-aws-credentials.md).

**nota**  
En versiones anteriores (anteriores a la 3.3.96.0) del, este cmdlet recibía el nombre. Herramientas de AWS para PowerShell`Initialize-AWSDefaults`

## Control de versiones
<a name="pstools-versioning-netcore"></a>

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-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).

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](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).

Para determinar la versión PowerShell que está ejecutando, escriba `$PSVersionTable` para ver el contenido de la variable `$PSVersionTable` [automática](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6).

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
<a name="pstools-updating-linux-netcore"></a>

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 las herramientas para PowerShell Core
<a name="update-netcore-all-systems"></a>

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](https://www.powershellgallery.com/packages/AWSPowerShell). 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
<a name="pstools-seealso-setup-netcore"></a>
+  [Configuración y uso del Herramientas de AWS para PowerShell](pstools-getting-started.md) 
+  [AWS Servicios de llamadas en el Herramientas de AWS para PowerShell](pstools-using.md) 