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 Outils AWS pour PowerShell sous Windows

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

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

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

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 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 sur le site Web de Microsoft.

Vous pouvez installer AWS.Tools de l'une des trois façons suivantes :

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 deux manières

À 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 Outils AWS pour 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 Outils AWS pour 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 entrez automatiquement 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' AWS Tools for Windows PowerShell installer de deux manières :

Pour effectuer une installation AWSPowerShell depuis 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.

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) sur le site Web Microsoft Technet.

Pour activer l'exécution du script

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 d'Outils pour Windows met automatiquement PSModulePathà jour le 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 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-.

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 PSVersionTable 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

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 modules AWS.Tools actuellement installés et, après une mise à jour réussie, supprime les autres versions installées.

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 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 AWS services n'est disponible qu'après la mise à jour vers une version compatible avec ce support.

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 Outils AWS pour PowerShell console personnalisée depuis le menu Démarrer.