La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1 Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](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) 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 Windows (recommandé) Pour obtenir des informations générales Outils AWS pour PowerShell sur l'installation de Windows, y compris les prérequis et les autres options, consultez la [rubrique parent](pstools-getting-set-up-windows.md). Pour plus d'informations sur les outils PowerShell qui y sont préinstallés AWS CloudShell, consultez[Installé sur CloudShell](pstools-getting-set-up-cloudshell.md). Vous pouvez installer la version modulaire du Outils AWS pour PowerShell sur les ordinateurs qui exécutent Windows PowerShell 5.1, PowerShell Core 6.0 ou version ultérieure. Pour plus d'informations sur l'installation de PowerShell Core, voir [Installation de différentes versions de PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) sur le site Web de Microsoft. 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 autres `AWS.Tools` modules. `AWS.Tools.Installer`nécessite`PowerShellGet`, 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 mettent `AWS.Tools.Installer` automatiquement à jour tous les autres `AWS.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](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)` et insérez-les dans l'un des dossiers du module. Vous pouvez découvrir les dossiers de vos modules en affichant la valeur de la variable d’environnement `PSModulePath`. **Avertissement** Après avoir téléchargé le fichier ZIP et avant d'en extraire le contenu, vous devrez peut-être le débloquer. Cela se fait généralement en ouvrant les propriétés du fichier, en consultant l'onglet **Général** et en cochant la case **Débloquer** s'il en existe une. Si le fichier ZIP doit être débloqué mais que vous ne le faites pas, des erreurs similaires au message suivant peuvent s'afficher : « Module d'importation : Impossible de charger le fichier ou l'assemblage ». + Installation de chaque module de service depuis la PowerShell galerie à l'aide de l'`Install-Module`applet de commande. **Pour installer sous `AWS.Tools` Windows à l'aide du `AWS.Tools.Installer` module** 1. Démarrez une PowerShell session. **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. 1. Pour installer le package `AWS.Tools` modulaire, 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 averti que le référentiel n'est pas approuvé, le système vous demandera si vous souhaitez effectuer l'installation malgré tout. Entrez **y** pour autoriser PowerShell l'installation du module. Pour éviter l'invite et installer le module sans approuver le référentiel, vous pourrez exécuter la commande avec le paramètre `-Force`. ``` PS > Install-Module -Name AWS.Tools.Installer -Force ``` 1. Vous pouvez désormais installer le module pour chaque AWS service que vous souhaitez utiliser à l'aide de l'`Install-AWSToolsModule`applet de commande. 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 également `AWS.Tools.Common`. Il s'agit d'un module partagé requis par tous les modules AWS de service. 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 le `PSRepository` nom `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) et considère qu'il s'agit d'une source fiable. Utilisez la commande `Get-PSRepository -Name PSGallery` pour plus d’informations sur ce `PSRepository`. Par défaut, la commande précédente installe les modules dans le dossier `%USERPROFILE%\Documents\WindowsPowerShell\Modules`. Pour installer le Outils AWS pour PowerShell pour tous les utilisateurs d'un ordinateur, vous devez exécuter la commande suivante dans une PowerShell session que vous avez démarrée en tant qu'administrateur. Par exemple, la commande suivante installe le module IAM dans le dossier `%ProgramFiles%\WindowsPowerShell\Modules` accessible à tous les utilisateurs. ``` PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers ``` Pour installer d'autres modules, exécutez des commandes similaires avec les noms de module appropriés, comme indiqué dans la [PowerShell galerie](https://www.powershellgallery.com/packages?q=aws). ## Activation de l'exécution du script Pour charger les Outils AWS pour PowerShell modules, vous devez activer l'exécution de PowerShell scripts. Pour activer l'exécution du script, exécutez l'applet de commande `Set-ExecutionPolicy` et définissez une stratégie `RemoteSigned`. Pour plus d'informations, consultez [About Execution Policies (À propos des politiques d'exécution)](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) sur le site Web Microsoft Technet. **Note** Ceci est une condition requise uniquement pour les ordinateurs qui exécutent Windows. La restriction de sécurité `ExecutionPolicy` n'est pas présente sur les autres systèmes d'exploitation. **Pour activer l'exécution du script** 1. Les droits d'administrateurs sont requis pour définir la politique d'exécution. Si vous n'êtes pas connecté en tant qu'utilisateur disposant de droits d'administrateur, ouvrez une PowerShell session en tant qu'administrateur. Choisissez **Démarrer**, puis **Tous les programmes**. Choisissez **Accessoires**, puis **Windows PowerShell**. Cliquez avec le bouton droit sur **Windows PowerShell**, puis dans le menu contextuel, sélectionnez **Exécuter en tant qu'administrateur**. 1. À partir de l’invite de commande, entrez la commande suivante : ``` PS > Set-ExecutionPolicy RemoteSigned ``` **Note** Sur un système 64 bits, vous devez effectuer cette opération séparément pour la version 32 bits de PowerShell **Windows PowerShell (x86).** Si la politique d'exécution n'est pas correctement définie, PowerShell affiche le message d'erreur suivant chaque fois que vous essayez d'exécuter un script, tel que votre profil. ``` File C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 cannot be loaded because the execution of scripts is disabled on this system. Please see "get-help about_signing" for more details. At line:1 char:2 + . <<<< 'C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1' + CategoryInfo : NotSpecified: (:) [], PSSecurityException + FullyQualifiedErrorId : RuntimeException ``` Le programme d' PowerShell installation de Tools for Windows met automatiquement à jour le [PSModulechemin](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_psmodulepath) pour inclure l'emplacement du répertoire contenant le `AWSPowerShell` module. Comme il `PSModulePath` inclut l'emplacement du répertoire du AWS module, l'`Get-Module -ListAvailable`applet de commande affiche le module. ``` PS > Get-Module -ListAvailable ModuleType Name ExportedCommands ---------- ---- ---------------- Manifest AppLocker {} Manifest BitsTransfer {} Manifest PSDiagnostics {} Manifest TroubleshootingPack {} Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol... ``` ## 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 des outils que vous avez installée, exécutez l'AWSPowerShellVersionapplet de commande [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html). 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] ``` Vous pouvez également ajouter le `-ListServiceVersionInfo` paramètre à une AWSPower ShellVersion commande [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) pour voir la liste des AWS services pris en charge dans la version actuelle des outils. Si vous utilisez l'option `AWS.Tools.*` modulaire, seuls les modules que vous avez importés seront affichés. Par exemple : ``` PS > Get-AWSPowerShellVersion -ListServiceVersionInfo ... Service Noun Prefix Module Name SDK Assembly Version ------- ----------- ----------- ----------- AWS IAM Access Analyzer IAMAA AWS.Tools.AccessAnalyzer 3.7.400.33 AWS Account ACCT AWS.Tools.Account 3.7.400.33 AWS Certificate Manager Private... PCA AWS.Tools.ACMPCA 3.7.400.34 AWS Amplify AMP AWS.Tools.Amplify 3.7.401.28 Amplify Backend AMPB AWS.Tools.AmplifyBackend 3.7.400.33 ... ``` Pour déterminer la version PowerShell que vous utilisez, entrez `$PSVersionTable` pour afficher le contenu de la [variable automatique](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) \$1 PSVersion Table. 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 Windows 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/](https://www.powershellgallery.com/)) et considère qu'il s'agit d'une source fiable. Utilisez la `Get-PSRepository -Name PSGallery` commande pour plus d'informations à ce sujet`PSRepository`.