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.
Installation AWS.Tools
sous Linux ou macOS (recommandé)
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.
Vous pouvez installer la version modulaire de Outils AWS pour PowerShell sur les ordinateurs qui exécutent PowerShell Core 6.0 ou version ultérieure. Pour plus d'informations sur l'installation de PowerShell Core, consultez la section Installation de différentes versions de PowerShell
Vous pouvez installer AWS.Tools
de l'une des trois façons suivantes :
Utilisez les applets de commande du module
AWS.Tools.Installer
. Ce module simplifie l'installation et la mise à jour des autresAWS.Tools
modules.AWS.Tools.Installer
nécessitePowerShellGet
, télécharge et installe automatiquement une version mise à jour de celui-ci.AWS.Tools.Installer
synchronise automatiquement les versions de vos modules. Lorsque vous installez ou mettez à jour une version plus récente d'un module, les applets de commande intégrés mettentAWS.Tools.Installer
automatiquement à jour tous les autresAWS.Tools
modules vers la même version.Cette méthode est décrite dans la procédure qui suit.
-
Téléchargez les modules depuis
AWS.Tools.zip
et ajoutez-les 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 de chaque module de service depuis la PowerShell galerie à l'aide de l'
Install-Module
applet de commande.
Pour installer sous AWS.Tools
Linux ou macOS à l'aide du AWS.Tools.Installer
module
-
Démarrez une session PowerShell Core en exécutant la commande suivante.
$
pwsh
Note
Nous vous recommandons de ne pas vous présenter PowerShell en tant qu'administrateur avec des autorisations élevées, sauf lorsque la tâche en cours l'exige. Ceci est dû au risque potentiel pour la sécurité et est incompatible avec le principe du moindre privilège.
-
Pour installer le package
AWS.Tools
modularisé à l'aide du moduleAWS.Tools.Installer
, exécutez la commande suivante.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 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 et installer le module sans approuver le référentiel, vous pouvez exécuter la commande suivante.PS >
Install-Module -Name AWS.Tools.Installer -Force -
Vous pouvez maintenant installer le module pour chaque service que vous souhaitez utiliser. Par exemple, la commande suivante installe les modules Amazon EC2 et Amazon S3. Cette commande installe également tous les modules dépendants nécessaires au fonctionnement du module spécifié. Par exemple, lorsque vous installez votre premier module de service
AWS.Tools
, il installe égalementAWS.Tools.Common
. Il s'agit d'un module partagé requis par tous les modules de service AWS . Il supprime également les anciennes versions des modules et met à jour les autres modules avec la même version plus récente.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
Note
L'
Install-AWSToolsModule
applet de commande télécharge tous les modules demandés depuis lePSRepository
nomPSGallery
(https://www.powershellgallery.com/) et considère le référentiel comme une source fiable. Utilisez la commande Get-PSRepository -Name PSGallery
pour plus d’informations sur cePSRepository
.La commande précédente installe les modules dans les répertoires par défaut de votre système. Les répertoires réels dépendent de la distribution et de la version de votre système d'exploitation ainsi PowerShell que de la version que vous avez installée. Par exemple, si vous avez installé PowerShell 7 sur un système de type RHEL, les modules par défaut se trouvent probablement dans
/opt/microsoft/powershell/7/Modules
(ou$PSHOME/Modules
) et les modules utilisateur se trouvent probablement dans.~/.local/share/powershell/Modules
Pour plus d'informations, consultez la section Installer sous Linux PowerShell surle PowerShell site Web de Microsoft. Pour voir où les modules sont installés, exécutez la commande suivante : PS >
Get-Module -ListAvailable
Pour installer d'autres modules, exécutez des commandes similaires avec les noms de module appropriés, comme indiqué dans la PowerShell galerie
.
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)
Comme il PSModulePath
inclut l'emplacement du répertoire du AWS module, l'Get-Module -ListAvailable
applet de commande affiche le module que vous avez installé.
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…
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 modules modularisés AWS.Tools
Pour mettre à jour vos AWS.Tools
modules avec la dernière version, exécutez la commande suivante :
PS >
Update-AWSToolsModule -CleanUp
Cette commande met à jour tous les AWS.Tools
modules actuellement installés et, après une mise à jour réussie, supprime les versions antérieures.
Note
L'Update-AWSToolsModule
applet de commande télécharge tous les modules depuis le PSRepository
nom PSGallery
(https://www.powershellgallery.com/Get-PSRepository -Name PSGallery
commande pour plus d'informations à ce sujetPSRepository
.