Installez AWSPower Shell. NetCore sous Linux ou macOS - Outils AWS pour PowerShell (version 5)

La version 5 (V5) du Outils AWS pour PowerShell est sortie !

Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la rubrique relative à la migration.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Installez AWSPower Shell. NetCore sous Linux ou macOS

Pour obtenir des informations générales sur l'installation Outils AWS pour PowerShell sur Linux ou macOS, y compris les prérequis et les autres options, consultez la rubrique parent.

Pour plus d'informations sur les outils PowerShell qui y sont préinstallés AWS CloudShell, consultezInstallé sur CloudShell.

Note

AWSPowerCoquille. NetCore n'est pas la méthode recommandée pour installer le Outils AWS pour PowerShell. Pour la méthode recommandée, voir Installation AWS.Tools (recommandée) plutôt.

Pour effectuer une mise à niveau vers une version plus récente de AWSPower Shell. NetCore, suivez les instructions figurant dansMettre à jour Outils AWS pour PowerShell le sous Linux ou macOS. Désinstallez les versions antérieures de AWSPower Shell. NetCore premier.

Vous pouvez installer AWSPower Shell. NetCore de l'une des deux manières suivantes :

  • Téléchargez le module depuis AWSPowerShell.NetCore.zip et ajoutez-le dans l'un des répertoires du module. Vous pouvez découvrir les répertoires de vos modules en imprimant la valeur de la variable $Env:PSModulePath.

  • Installation depuis la PowerShell galerie à l'aide de l'Install-Moduleapplet de commande, comme décrit dans la procédure suivante.

Pour installer AWSPower Shell. NetCore sous Linux ou macOS à l'aide de l'applet de commande Install-Module

Démarrez une session PowerShell Core en exécutant la commande suivante.

$ pwsh
Note

Nous vous recommandons de ne pas commencer PowerShell par courir sudo pwsh pour exécuter PowerShell avec des droits d'administrateur élevés. Ceci est dû au risque potentiel pour la sécurité et est incompatible avec le principe du moindre privilège.

Pour installer le AWSPower Shell. NetCore package mono-module depuis la PowerShell galerie, exécutez la commande suivante.

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 vous êtes informé que le dépôt n'est « pas fiable », il vous est demandé si vous souhaitez quand même l'installer. Entrez y pour autoriser PowerShell l'installation du module. Pour éviter l'invite sans approuver le référentiel, vous pouvez exécuter la commande suivante.

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

Il n'est pas nécessaire d'exécuter cette commande en tant que root, sauf si vous souhaitez l'installer Outils AWS pour PowerShell pour tous les utilisateurs d'un ordinateur. Pour ce faire, exécutez la commande suivante dans une PowerShell session que vous avez démarréesudo pwsh.

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

Exécution de script

La commande Set-ExecutionPolicy n'est pas disponible sur les systèmes autres que Windows. Vous pouvez exécuterGet-ExecutionPolicy, ce qui montre que le paramètre de politique d'exécution par défaut dans PowerShell Core exécuté sur des systèmes autres que Windows estUnrestricted. Pour plus d'informations, consultez About Execution Policies (À propos des politiques d'exécution) sur le site Web Microsoft Technet.

Comme il PSModulePath inclut l'emplacement du répertoire du AWS module, l'Get-Module -ListAvailableapplet de commande affiche le module que vous avez installé.

AWSPowerCoquille. NetCore

PS > Get-Module -ListAvailable Directory: /Users/username/.local/share/powershell/Modules ModuleType Version Name ExportedCommands ---------- ------- ---- ---------------- Binary 3.3.563.1 AWSPowerShell.NetCore

Configurez une PowerShell console pour utiliser le AWS Tools for PowerShell Core (AWSPowerShell). NetCore Uniquement)

PowerShell Core charge généralement les modules automatiquement chaque fois que vous exécutez une applet de commande dans le module. Mais cela ne fonctionne pas pour AWSPower Shell. NetCore en raison de sa grande taille. Pour commencer à exécuter AWSPower Shell. NetCore applets de commande, vous devez d'abord exécuter la Import-Module AWSPowerShell.NetCore commande. Ceci n'est pas requis pour les applets de commande dans les modules AWS.Tools.

Initialisez votre session PowerShell

Lorsque vous démarrez PowerShell sur un système basé sur Linux ou macOS après avoir installé le Outils AWS pour PowerShell, vous devez exécuter AWSDefaultInitialize-Configuration pour spécifier la clé d'accès à utiliser. AWS Pour plus d’informations sur Initialize-AWSDefaultConfiguration, consultez Utilisation des AWS informations d'identification.

Note

Dans les versions antérieures (antérieures à la version 3.3.96.0) de Outils AWS pour PowerShell, cette applet de commande était nommée. Initialize-AWSDefaults

Gestion des versions

AWS publie Outils AWS pour PowerShell régulièrement de nouvelles versions pour prendre en charge les nouveaux AWS services et fonctionnalités. Pour déterminer la version Outils AWS pour PowerShell que vous avez installée, exécutez l'AWSPowerShellVersionapplet de commande Get-.

Par exemple :

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]

Pour consulter la liste des AWS services pris en charge dans la version actuelle des outils, ajoutez le -ListServiceVersionInfo paramètre à une AWSPower ShellVersion applet de commande Get-.

Pour déterminer la version PowerShell que vous utilisez, entrez $PSVersionTable pour afficher le contenu de la variable $PSVersionTable automatique.

Par exemple :

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

Mettre à jour Outils AWS pour PowerShell le sous Linux ou macOS

Régulièrement, au fur et à mesure que des versions mises à jour Outils AWS pour PowerShell sont publiées, vous devez mettre à jour la version que vous exécutez localement.

Mettre à jour les outils pour PowerShell Core

Exécutez l'Get-AWSPowerShellVersionapplet de commande pour déterminer la version que vous exécutez et comparez-la à la version de Tools for Windows disponible sur le PowerShell site Web de la PowerShell galerie. Nous vous suggérons d'effectuer cette vérification toutes les deux à trois semaines. Support pour les nouvelles commandes et AWS services n'est disponible qu'après la mise à jour vers une version compatible avec ce support.

Avant d'installer une version plus récente de AWSPower Shell. NetCore, désinstallez le module existant. Fermez toutes les PowerShell sessions ouvertes avant de désinstaller le package existant. Exécutez la commande suivante pour désinstaller le package.

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

Une fois le package désinstallé, installez le module mis à jour en exécutant la commande suivante.

PS > Install-Module -Name AWSPowerShell.NetCore

Après l'installation, exécutez la commande Import-Module AWSPowerShell.NetCore pour charger les applets de commande mis à jour dans votre PowerShell session.

Informations connexes