Installation de l'AWS Tools for PowerShell sur Windows
Un ordinateur Windows peut exécuter n'importe laquelle des options de package des AWS Tools for PowerShell suivantes :
-
AWS.Tools – Version modulaire des AWS Tools for PowerShell. Chaque service AWS est pris en charge par son propre petit module individuel, avec les modules de support partagés
AWS.Tools.Common
etAWS.Tools.Installer
. -
AWSPowerShell.NetCore – Version grand module unique de AWS Tools for PowerShell. Tous les services AWS sont pris en charge par ce grand module unique.
-
AWSPowerShell – La version simple et existante, spécifique à Windows, du grand module de AWS Tools for PowerShell. Tous les services AWS 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.
Les Tools for Windows PowerShell (AWSPowerShell module) sont installés par défaut sur toutes les AMI (Amazon Machine Images) basées sur Windows.
La configuration des AWS Tools for PowerShell implique les tâches de haut niveau suivantes, décrites en détail dans cette rubrique.
-
Installez l'option de package des AWS Tools for PowerShell appropriée à votre environnement.
-
Vérifiez que l'exécution de script est activée en exécutant l'applet de commande
Get-ExecutionPolicy
. -
Importez le module AWS Tools for PowerShell dans votre session PowerShell.
Prerequisites
Assurez-vous que vous répondez aux exigences indiquées dans Conditions préalables à la configuration des AWS Tools for PowerShell.
Des versions plus récentes de PowerShell, y compris PowerShell Core, sont disponibles sous forme de téléchargements à partir de la page Installing various versions of PowerShell (Installation des différentes versions de PowerShell)
Installer AWS.Tools
sous Windows.
Vous pouvez installer la version modulaire des AWS Tools for PowerShell sur les ordinateurs qui exécutent Windows avec Windows PowerShell version 5.1 ou PowerShell Core version 6.0 ou ultérieure. Pour plus d'informations sur l'installation de PowerShell Core, consultez Installing various versions of PowerShell (Installation des 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
. Le moduleAWS.Tools.Installer
simplifie l'installation et la mise à jour d'autres modulesAWS.Tools
.AWS.Tools.Installer
nécessite, télécharge et installe automatiquement, une version mise à jour dePowerShellGet
. Le moduleAWS.Tools.Installer
permet également de synchroniser automatiquement les versions de vos modules. Lorsque vous procédez à l’installation ou à la mise à jour avec une version plus récente d'un module, les applets de commande du moduleAWS.Tools.Installer
actualisent automatiquement tous vos autres modulesAWS.Tools
avec la même version. -
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 imprimant la valeur de la variable$Env:PSModulePath
. -
Installez chaque module de service à partir de la galerie PowerShell à l'aide de l'applet de commande
Install-Module
, comme décrit dans la procédure suivante.
Pour installer AWS.Tools
sous Windows à l'aide de l'applet de commande Install-Module
-
Démarrez une session PowerShell.
Note Nous vous recommandons de ne pas exécuter PowerShell en tant qu'administrateur avec des autorisations de niveau élevé, 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
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 à installer le 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 -
Vous pouvez maintenant installer le module pour chaque service AWS que vous souhaitez utiliser à l’aide de la commande d’applet
Install-AWSToolsModule
. Par exemple, la commande suivante installe le module IAM. 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 serviceAWS.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'applet de commande
Install-AWSToolsModule
télécharge tous les modules demandés à partir duPSRepository
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 cePSRepository
.Par défaut, cette commande installe les modules dans le dossier
$home\Documents\PowerShell\Modules
. Pour installer les AWS Tools for PowerShell pour tous les utilisateurs d'un ordinateur, vous devez exécuter la commande suivante dans une session PowerShell que vous aurez démarrée en tant qu'administrateur. Ceci installe les modules dans le dossier$env:ProgramFiles\PowerShell\Modules
qui est accessible par tous les utilisateurs.PS >
Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers
Installer AWSPowerShell.NetCore sur Windows
Vous pouvez installer AWSPowerShell.NetCore sur les ordinateurs qui exécutent Windows avec PowerShell versions 3 à 5.1, ou PowerShell Core 6.0 ou version ultérieure. Pour de plus amples informations sur l'installation de PowerShell Core, veuillez consulter Installation des différentes versions de PowerShell
Vous pouvez installer AWSPowerShell.NetCore de l'une de deux façons :
-
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
. -
Installez-le à partir de la galerie PowerShell à l'aide de l'applet de commande
Install-Module
, comme décrit dans la procédure suivante.
Pour installer AWSPowerShell.NetCore à partir de la galerie PowerShell à l'aide de l'applet de commande Install-Module
Pour que vous puissiez installer AWSPowerShell.NetCore à partir de la galerie PowerShell, votre ordinateur doit exécuter PowerShell 5.0 ou version ultérieure, ou exécuter PowerShellGet
PS >
Install-Module -name AWSPowerShell.NetCore
Si vous exécutez PowerShell en tant qu'administrateur, la commande précédente installera les AWS Tools for PowerShell pour tous les utilisateurs de l'ordinateur. Si vous exécutez PowerShell en tant qu'utilisateur standard sans autorisations d'administrateur, cette même commande installera les AWS Tools for PowerShell uniquement 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 PowerShell 3.0 ou version ultérieure charge généralement les modules dans votre session PowerShell la première fois que vous exécutez une applet de commande dans le module, la taille du module AWSPowerShell.NetCore est trop importante pour qu'il puisse prendre en charge cette fonctionnalité. Vous devez plutôt charger explicitement le module AWSPowerShell.NetCore dans votre session PowerShell en exécutant la commande suivante.
PS >
Import-Module AWSPowerShell.NetCore
Pour charger automatiquement le module AWSPowerShell.NetCore dans une session PowerShell, ajoutez cette commande à votre profil PowerShell. Pour de plus amples informations sur la modification de votre profil PowerShell, veuillez consulter About Profiles
Installer AWSPowerShell sur Windows PowerShell
Vous pouvez installer AWS Tools for Windows PowerShell de l'une des trois façons suivantes :
-
Téléchargez le module depuis AWSPowerShell.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
. -
Exécution du programme d'installation Tools for Windows PowerShell
. Cette méthode d'installation d'AWSPowerShell est obsolète et nous vous recommandons d'utiliser Install-Module
à la place. -
Installez-le à partir de la galerie PowerShell à l'aide de l'applet de commande
Install-Module
, comme décrit dans la procédure suivante.
Pour installer AWSPowerShell à partir de la galerie PowerShell à l'aide de l'applet de commande Install-Module
Vous pouvez installer AWSPowerShell à partir de la galerie PowerShell si vous exécutez PowerShell 5.0 ou version ultérieure, ou si vous avez installé PowerShellGet
PS >
Install-Module -Name AWSPowerShell
Pour charger automatiquement le module AWSPowerShell dans une session PowerShell, ajoutez l'applet de commande import-module
précédente à votre profil PowerShell. Pour de plus amples informations sur la modification de votre profil PowerShell, veuillez consulter About Profiles
Les Tools for Windows PowerShell sont installés par défaut sur toutes les AMI (Amazon Machine Images) basées sur Windows.
Activation de l'exécution du script
Pour charger les modules AWS Tools for PowerShell, vous devez activer l'exécution du script PowerShell. 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)
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
-
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 session PowerShell 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 choisissez Exécuter en tant qu'administrateur dans le menu contextuel.
-
À partir de l'invite de commande, entrez la commande suivante :
PS >
Set-ExecutionPolicy RemoteSigned
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 définie correctement, PowerShell affichera l'erreur suivante chaque fois que vous essaierez 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'installation de Tools for Windows PowerShell met automatiquement à jour la variable PSModulePathAWSPowerShell
.
Étant donné que PSModulePath
inclut l'emplacement du répertoire du module AWS, l'applet de commande Get-Module -ListAvailable
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...
Versioning
AWS publie régulièrement de nouvelles versions des AWS Tools for PowerShell pour prendre en charge de nouveaux services et fonctionnalités AWS. Pour déterminer quelle version des outils vous avez installée, exécutez l'applet de commande Get-AWSPowerShellVersion.
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 paramètre -ListServiceVersionInfo
à une commande Get-AWSPowerShellVersion pour afficher la liste des services AWS 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 de PowerShell que vous exécutez, saisissez $PSVersionTable
pour afficher le contenu de la variable automatique
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
Mise à jour des AWS Tools for PowerShell sur Windows
Vous devez régulièrement mettre à jour la version des AWS Tools for PowerShell que vous exécutez localement, à mesure que des versions mises à jour sont publiées.
Mettez à jour les AWS.Tools
modulaires
Pour mettre à niveau vos modules AWS.Tools
vers 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.
L'applet de commande Update-AWSToolsModule
télécharge tous les modules à partir du PSRepository
appelé PSGallery
(https://www.powershellgallery.com/Get-PSRepository -Name PSGallery
pour plus d’informations sur ce PSRepository
.
Mise à jour des outils pour PowerShell Core
Exécutez l'applet de commande Get-AWSPowerShellVersion
pour déterminer quelle version vous exécutez et comparez-la à la version des Tools for Windows PowerShell disponible sur le site Web PowerShell Gallery
Avant d'installer une version plus récente d'AWSPowerShell.NetCore, désinstallez le module existant. Fermez toutes les sessions PowerShell 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 mises à jour dans votre session PowerShell.
Mise à jour des Tools for Windows PowerShell
Exécutez l'applet de commande Get-AWSPowerShellVersion
pour déterminer quelle version vous exécutez et comparez-la à la version des Tools for Windows PowerShell disponible sur le site Web PowerShell Gallery
-
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 du programme d'installation de package
.msi
ou à l'aide d'un fichier ZIP téléchargé :-
Téléchargez la version la plus récente du package MSI à partir du site Web Tools for PowerShell
. 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
. -
Si la version de téléchargement est supérieure à celle que vous avez installée, fermez toutes les consoles Tools for Windows PowerShell.
-
Installez la version plus récente de Tools for Windows PowerShell.
-
Après l'installation, exécutez Import-Module AWSPowerShell
pour charger les applets de commande mises à jour dans votre session PowerShell. Ou exécutez la console des AWS Tools for PowerShell personnalisée à partir de votre menu Démarrer.