La version 5 (V5) du Outils AWS pour PowerShell est sortie \!
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.
# 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](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).
**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)](ps-installing-awstools.md) 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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-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](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/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-Module`applet 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](https://www.powershellgallery.com/packages/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](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles) 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)](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 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](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) $ 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-AWSPowerShellVersion`applet 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](https://www.powershellgallery.com/packages/AWSPowerShell). 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.