Installation du AWS Tools for PowerShell sous Windows - AWS Tools for PowerShell
PrérequisInstaller AWS.ToolsInstallez AWSPowerShell. NetCoreInstaller AWSPowerShellActivation de l'exécution du scriptGestion des versionsMise à jour AWS Tools for PowerShell

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 du AWS Tools for PowerShell sous Windows

Un ordinateur Windows peut exécuter n'importe laquelle des options du AWS Tools for PowerShell package :

  • AWS.Tools- La version modularisée de. AWS Tools for PowerShell Chaque AWS service est pris en charge par son propre petit module individuel, avec des modules de support partagés AWS.Tools.Common etAWS.Tools.Installer.

  • AWSPowerShell. NetCore- La version à module unique de. AWS Tools for PowerShell Tous les AWS services sont pris en charge par ce grand module unique.

    Note

    Notez que le module unique est peut-être trop volumineux pour être utilisé avec des fonctions AWS Lambda. Utilisez plutôt la version modulaire présentée ci-dessus.

  • AWSPowerShell - La version simple et existante, spécifique à Windows, du grand module des AWS Tools for PowerShell. Tous les AWS services sont pris en charge par ce grand module unique.

Le package que vous choisissez dépend de la version et de l'édition de Windows que vous exécutez.

Note

Les outils pour Windows PowerShell (AWSPowerShell module) sont installés par défaut sur toutes les Amazon Machine Images (AMI) basées sur Windows.

La configuration de AWS Tools for PowerShell implique les tâches de haut niveau suivantes, décrites en détail dans cette rubrique.

  1. Installez l'option de AWS Tools for PowerShell package adaptée à votre environnement.

  2. Vérifiez que l'exécution de script est activée en exécutant l'applet de commande Get-ExecutionPolicy.

  3. Importez le AWS Tools for PowerShell module dans votre PowerShell session.

Prérequis

Les versions les plus récentes de PowerShell, y compris PowerShell Core, sont disponibles en téléchargement auprès de Microsoft à l'adresse Installation de différentes versions de PowerShell sur le site Web de Microsoft.

Installer AWS.Tools sous Windows.

Vous pouvez installer la version modulaire de AWS Tools for 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 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.InstallernécessitePowerShellGet, télécharge et installe automatiquement une version mise à jour de celui-ci. AWS.Tools.Installersynchronise 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 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.

  • Installation de chaque module de service depuis la PowerShell galerie à l'aide de l'Install-Moduleapplet 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.

  2. 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

  3. Vous pouvez désormais installer le module pour chaque AWS service que vous souhaitez utiliser à l'aide de l'Install-AWSToolsModuleapplet 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'applet de commande Install-AWSToolsModule télécharge tous les modules demandés à partir du PSRepository appelé PSGallery (https://www.powershellgallery.com/) et le considère comme 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 AWS Tools for 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.

Installez AWSPowerShell. NetCore sous Windows

Vous pouvez installer le AWSPowerShell. NetCore sur les ordinateurs qui exécutent Windows avec les PowerShell versions 3 à 5.1, ou 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 sur le PowerShell site Web de Microsoft.

Vous pouvez installer AWSPowerShell. NetCore de l'une des deux manières

  • Téléchargement du module depuis AWSPowerShell. NetCore.zip et en l'extrayant dans l'un des répertoires du module. Vous pouvez découvrir les répertoires de vos modules en affichant la valeur de la variable d’environnement PSModulePath.

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

À installer AWSPowerShell. NetCore depuis la PowerShell galerie à l'aide de l'applet de commande Install-Module

Pour installer le AWSPowerShell. NetCore depuis la PowerShell Galerie, votre ordinateur doit exécuter la PowerShell version 5.0 ou ultérieure, ou la version PowerShell 3 ou une version ultérieure. PowerShellGet Exécutez la commande suivante.

PS > Install-Module -name AWSPowerShell.NetCore

Si vous exécutez en PowerShell tant qu'administrateur, la commande précédente s'installe AWS Tools for PowerShell pour tous les utilisateurs de l'ordinateur. Si vous vous lancez PowerShell en tant qu'utilisateur standard sans autorisation d'administrateur, cette même commande s'installe uniquement AWS Tools for PowerShell pour l'utilisateur actuel.

Pour effectuer une installation uniquement pour l'utilisateur actuel lorsque ce dernier dispose d'autorisations d'administrateur, exécutez la commande avec le jeu de paramètres -Scope CurrentUser, comme suit.

PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser

Bien que les versions PowerShell 3.0 et ultérieures chargent généralement des modules dans votre PowerShell session la première fois que vous exécutez une applet de commande dans le module, le. AWSPowerShell NetCore le module est trop volumineux pour prendre en charge cette fonctionnalité. Vous devez plutôt charger explicitement le AWSPowerShell. NetCore Intégrez le module principal à votre PowerShell session en exécutant la commande suivante.

PS > Import-Module AWSPowerShell.NetCore

Pour charger le AWSPowerShell. NetCore insérez automatiquement cette commande dans une PowerShell session, ajoutez cette commande à votre PowerShell profil. Pour plus d'informations sur la modification de votre PowerShell profil, consultez la section À propos des profils dans la PowerShell documentation.

Installation AWSPowerShell sous Windows PowerShell

Vous pouvez l'installer de AWS Tools for Windows PowerShell l'une des deux manières suivantes :

  • Télécharger le module depuis un AWSPowerShellfichier .zip et l'extraire dans l'un des répertoires du module. Vous pouvez découvrir les répertoires de vos modules en affichant la valeur de la variable d’environnement PSModulePath.

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

Pour effectuer une installation à AWSPowerShell partir de la PowerShell galerie à l'aide de l'applet de commande Install-Module

Vous pouvez l'installer AWSPowerShell depuis la PowerShell galerie si vous utilisez la PowerShell version 5.0 ou une version ultérieure, ou si vous avez installé PowerShellGetla version PowerShell 3 ou une version ultérieure. Vous pouvez installer et mettre à jour à AWSPowerShell partir de la PowerShellgalerie Microsoft en exécutant la commande suivante.

 PS > Install-Module -Name AWSPowerShell

Pour charger automatiquement le AWSPowerShell module dans une PowerShell session, ajoutez l'import-moduleapplet de commande précédente à votre PowerShell profil. Pour plus d'informations sur la modification de votre PowerShell profil, consultez la section À propos des profils dans la PowerShell documentation.

Note

Les outils pour Windows PowerShell sont installés par défaut sur toutes les Amazon Machine Images (AMI) basées sur Windows.

Activation de l'exécution du script

Pour charger les AWS Tools for 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) 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.

  2. À 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 l'erreur suivante 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 ModulePath à jour le PS 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 -ListAvailableapplet 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 AWS Tools for 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-.

PS > Get-AWSPowerShellVersion

Tools for PowerShell
Version 4.1.11.0
Copyright 2012-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.

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

Vous pouvez également ajouter le -ListServiceVersionInfo paramètre à une AWSPowerShellVersion commande Get- 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.

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
Alexa For Business                 ALXB        AWS.Tools.AlexaForBusiness        3.7.0.11
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.0.11
Amazon API Gateway                 AG          AWS.Tools.APIGateway              3.7.0.11
Amazon API Gateway Management API  AGM         AWS.Tools.ApiGatewayManagementApi 3.7.0.11
Amazon API Gateway V2              AG2         AWS.Tools.ApiGatewayV2            3.7.0.11
Amazon Appflow                     AF          AWS.Tools.Appflow                 3.7.1.4
Amazon Route 53                    R53         AWS.Tools.Route53                 3.7.0.12
Amazon Route 53 Domains            R53D        AWS.Tools.Route53Domains          3.7.0.11
Amazon Route 53 Resolver           R53R        AWS.Tools.Route53Resolver         3.7.1.5
Amazon Simple Storage Service (S3) S3          AWS.Tools.S3                      3.7.0.13
...

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

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 AWS Tools for PowerShell le sous Windows

Régulièrement, à mesure que des versions mises à jour AWS Tools for 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 modules AWS.Tools actuellement installés et, après une mise à jour réussie, supprime les autres versions installées.

Note

L'applet de commande Update-AWSToolsModule télécharge tous les modules à partir du PSRepository appelé PSGallery (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 ce PSRepository.

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 les nouveaux AWS services uniquement après la mise à jour vers une version avec ce support.

Avant d'installer une version plus récente de AWSPowerShell. 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.

Mettre à jour les outils pour Windows PowerShell

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 les nouveaux AWS services uniquement après la mise à jour vers une version avec ce support.

  • Si vous avez effectué l'installation à l'aide de l'applet de commande Install-Module, exécutez les commandes suivantes.

    PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell

  • Si vous avez effectué l'installation à l'aide d'un fichier ZIP téléchargé :

    1. Téléchargez la version la plus récente sur le site PowerShell Web Tools for. Comparez le numéro de version du package dans le nom de fichier téléchargé avec le numéro de version que vous obtenez lorsque vous exécutez l'applet de commande Get-AWSPowerShellVersion.

    2. Si le nombre de versions téléchargées est supérieur à celui de la version que vous avez installée, fermez tous les outils pour PowerShell consoles Windows.

    3. Installez la version la plus récente des outils pour Windows PowerShell.

Après l'installation, exécutez Import-Module AWSPowerShell pour charger les applets de commande mis à jour dans votre PowerShell session. Vous pouvez également exécuter la AWS Tools for PowerShell console personnalisée depuis le menu Démarrer.