Activation de l'exécution du script Gestion des versions Mise à jour Outils AWS pour PowerShell

Installez AWSPower Shell. NetCore sous Windows

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.

Pour plus d'informations sur les outils PowerShell qui y sont préinstallés AWS CloudShell, consultezInstallé sur CloudShell.

Note

AWSPowerCoquille. NetCore n'est pas la méthode recommandée pour installer le Outils AWS pour PowerShell. Pour la méthode recommandée, voir Installation AWS.Tools (recommandée) plutôt.

Vous pouvez installer le AWSPower Shell. 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 AWSPower Shell. NetCore de 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.

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 depuis la PowerShell galerie à l'aide de l'Install-Moduleapplet de commande, comme décrit dans la procédure suivante.

Pour installer AWSPower Shell. NetCore depuis la PowerShell galerie à l'aide de l'applet de commande Install-Module

Pour installer le AWSPower Shell. 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 exécutez en PowerShell 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 AWSPower Shell. NetCore le module est trop volumineux pour prendre en charge cette fonctionnalité. Vous devez plutôt charger le AWSPower Shell de manière explicite. NetCore Intégrez le module principal à votre PowerShell session en exécutant la commande suivante.


PS > Import-Module AWSPowerShell.NetCore

Pour charger le AWSPower Shell. 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.

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.

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

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.
À 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 à jour le PSModulechemin 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-.

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- 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 $ 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, à 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 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 AWSPower Shell. 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.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Installation AWS.Tools (recommandée)

Installer AWSPower Shell (ancienne version)