Installazione AWS Tools for PowerShell su Linux o macOS

Questo argomento fornisce istruzioni su come installarlo AWS Tools for PowerShell su Linux o macOS.

Panoramica della configurazione

Per l'installazione AWS Tools for PowerShell su un computer Linux o macOS, puoi scegliere tra due opzioni di pacchetto:

• AWS.Tools— La versione modulare di. AWS Tools for PowerShell Ogni AWS servizio è supportato da un proprio piccolo modulo individuale, con moduli di supporto condivisi. AWS.Tools.Common

• AWSPowerShell. NetCore— La versione a modulo singolo di grandi dimensioni di AWS Tools for PowerShell. Tutti i AWS servizi sono supportati da questo unico modulo di grandi dimensioni.

  Nota

  Tieni presente che il singolo modulo potrebbe essere troppo grande per essere utilizzato con le funzioni AWS Lambda. Utilizza invece la versione modulare mostrata in precedenza.

L'impostazione di una di queste versioni su un computer su cui è in esecuzione Linux o macOS comporta le seguenti attività, descritte in dettaglio più avanti in questo argomento:

1. Installa PowerShell Core 6.0 o versione successiva su un sistema supportato.

2. Dopo aver installato PowerShell Core, inizia PowerShell eseguendolo pwsh nella shell del sistema.

3. Installa uno AWS.Tools o AWSPowerShell. NetCore.

4. Esegui il Import-Module cmdlet appropriato per importare il modulo nella sessione PowerShell.

5. Esegui il AWSDefaultConfiguration cmdlet Initialize- per fornire le tue credenziali. AWS

Prerequisiti

Per eseguire AWS Tools for PowerShell Core, sul computer deve essere in esecuzione PowerShell Core 6.0 o versione successiva.

• Per un elenco delle versioni supportate della piattaforma Linux e per informazioni su come installare la versione più recente di PowerShell su un computer basato su Linux, vedi Installazione PowerShell su Linux sul sito Web di Microsoft. Alcuni sistemi operativi basati su Linux, ad esempio Arch, Kali e Raspbian non sono supportati ufficialmente, ma hanno vari livelli di supporto dalla comunità.

• Per informazioni sulle versioni di macOS supportate e su come installare la versione più recente di su PowerShell macOS, consulta Installazione su PowerShell macOS sul sito Web di Microsoft.

Installazione di AWS.Tools su Linux o macOS

È possibile installare la versione modulare di AWS Tools for PowerShell su computer che PowerShell eseguono Core 6.0 o versione successiva. Per informazioni su come installare PowerShell Core, vedi Installazione di varie versioni PowerShell sul PowerShell sito Web di Microsoft.

È possibile installare AWS.Tools in uno dei tre modi:

• Utilizzo dei cmdlet nel modulo AWS.Tools.Installer. Questo modulo semplifica l'installazione e l'aggiornamento di altri AWS.Tools moduli. AWS.Tools.Installerrichiede PowerShellGet e ne scarica e installa automaticamente una versione aggiornata. AWS.Tools.Installermantiene automaticamente sincronizzate le versioni del modulo. Quando si installa o si esegue l'aggiornamento a una versione più recente di un modulo, i cmdlet inclusi aggiornano AWS.Tools.Installer automaticamente tutti gli altri AWS.Tools moduli alla stessa versione.

  Questo metodo è descritto nella procedura che segue.

• Scaricando i moduli da AWS.Tools.zip ed estraendoli in una delle directory dei moduli. È possibile scoprire le directory dei moduli stampando il valore della variabile $Env:PSModulePath.

• Installazione di ogni modulo di servizio dalla PowerShell Galleria utilizzando il Install-Module cmdlet.

Per installare AWS.Tools su Linux o macOS utilizzando il modulo AWS.Tools.Installer

1. Avvia una sessione PowerShell Core eseguendo il comando seguente.

   $ pwsh

   Nota

   Ti consigliamo di non lavorare PowerShell come amministratore con autorizzazioni elevate, tranne quando richiesto dall'attività in questione. Ciò è dovuto al potenziale rischio per la sicurezza ed è in contrasto con il principio del privilegio minimo.

2. Per installare il pacchetto AWS.Tools modularizzato utilizzando il modulo AWS.Tools.Installer, eseguire il seguente comando.

   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

   Se ricevi una notifica in cui è indicato che il repository non è attendibile, ti viene chiesto se vuoi installarlo comunque. Inserisci y per consentire l' PowerShell installazione del modulo. Per evitare il prompt e installare il modulo senza dover considerare attendibile il repository, puoi eseguire il seguente comando.

   PS > Install-Module -Name AWS.Tools.Installer -Force

3. Ora puoi installare il modulo per ogni servizio che desideri utilizzare. Ad esempio, il seguente comando installa i moduli Amazon EC2 e Amazon S3. Questo comando installa anche tutti i moduli dipendenti necessari per il funzionamento del modulo specificato. Ad esempio, quando installi il primo modulo di servizio AWS.Tools, viene installato anche AWS.Tools.Common. Si tratta di un modulo condiviso richiesto da tutti i moduli AWS di servizio. Rimuove anche le versioni precedenti dei moduli e aggiorna altri moduli alla stessa versione più recente.

   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

   Nota

   Il cmdlet Install-AWSToolsModule scarica tutti i moduli richiesti da PSRepository con nome PSGallery (https://www.powershellgallery.com/) e considera il repository come un'origine attendibile. Usa il comando Get-PSRepository -Name PSGallery per ulteriori informazioni su PSRepository.

   Il comando precedente installa i moduli nelle directory predefinite del sistema. Le directory effettive dipendono dalla distribuzione e dalla versione del sistema operativo e dalla versione installata. PowerShell Ad esempio, se avete installato PowerShell 7 su un sistema simile a RHEL, molto probabilmente i moduli predefiniti si trovano in /opt/microsoft/powershell/7/Modules (or$PSHOME/Modules) e i moduli utente si trovano molto probabilmente in. ~/.local/share/powershell/Modules Per ulteriori informazioni, vedere Installazione PowerShell su Linux sul PowerShell sito Web Microsoft. Per vedere dove sono installati i moduli, esegui il comando seguente:

   PS > Get-Module -ListAvailable

   Per installare altri moduli, esegui comandi simili con i nomi dei moduli appropriati, come si trova nella PowerShell Galleria.

Installa AWSPowerShell. NetCore su Linux o macOS

Per eseguire l'aggiornamento a una versione più recente di AWSPowerShell. NetCore, segui le istruzioni riportate inAggiornamento di AWS Tools for PowerShell su Linux o macOS. Disinstalla le versioni precedenti di AWSPowerShell. NetCore prima.

È possibile installare AWSPowerShell. NetCore in due modi:

• Scaricando il modulo da AWSPowerShell.NetCore.zip ed estraendolo in una delle directory del modulo. È possibile scoprire le directory dei moduli stampando il valore della variabile $Env:PSModulePath.

• Installazione dalla PowerShell Galleria utilizzando il Install-Module cmdlet come descritto nella procedura seguente.

Per installare. AWSPowerShell NetCore su Linux o macOS utilizzando il cmdlet Install-Module

Avviare una sessione PowerShell Core eseguendo il comando seguente.

$ pwsh

Nota

Ti consigliamo di non iniziare PowerShell eseguendo sudo pwsh l'esecuzione PowerShell con diritti di amministratore elevati. Ciò è dovuto al potenziale rischio per la sicurezza ed è in contrasto con il principio del privilegio minimo.

Per installare il. AWSPowerShell NetCore pacchetto a modulo singolo dalla PowerShell Galleria, esegui il seguente comando.

PS > Install-Module -Name AWSPowerShell.NetCore

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

Se ricevi una notifica in cui è indicato che il repository non è attendibile, ti viene chiesto se vuoi installarlo comunque. Inserisci y per consentire PowerShell l'installazione del modulo. Per evitare il prompt senza dover considerare attendibile il repository, puoi eseguire il comando riportato qui di seguito.

PS > Install-Module -Name AWSPowerShell.NetCore -Force

Non è necessario eseguire questo comando come root, a meno che non si desideri installarlo AWS Tools for PowerShell per tutti gli utenti di un computer. Per fare ciò, esegui il comando seguente in una PowerShell sessione con cui hai iniziatosudo pwsh.

PS > Install-Module -Scope AllUsers -Name AWSPowerShell.NetCore -Force

Esecuzione di uno script

Il comando Set-ExecutionPolicy non è disponibile sui sistemi non Windows. Puoi eseguireGet-ExecutionPolicy, il che dimostra che l'impostazione predefinita dei criteri di esecuzione in PowerShell Core in esecuzione su sistemi non Windows èUnrestricted. Per ulteriori informazioni, consulta Informazioni sulle policy di esecuzione sul sito Web Microsoft Technet.

Poiché PSModulePath include la posizione della directory del AWS modulo, il Get-Module -ListAvailable cmdlet mostra il modulo installato.

AWS.Tools

PS > Get-Module -ListAvailable

    Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version    Name                                PSEdition ExportedCommands
---------- -------    ----                                --------- ----------------
Binary     3.3.563.1  AWS.Tools.Common                    Desk      {Clear-AWSHistory, Set-AWSHistoryConfiguration, Initialize-AWSDefaultConfiguration, Clear-AWSDefaultConfigurat…

AWSPowerShell.NetCore

PS > Get-Module -ListAvailable

Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Binary     3.3.563.1  AWSPowerShell.NetCore

Configurare una PowerShell console per utilizzare (. AWS Tools for PowerShell Core AWSPowerShell NetCore Solo)

PowerShell Core in genere carica automaticamente i moduli ogni volta che si esegue un cmdlet nel modulo. Ma questo non funziona per. AWSPowerShell NetCore a causa delle sue grandi dimensioni. Per iniziare a correre AWSPowerShell. NetCore cmdlet, è necessario innanzitutto eseguire il Import-Module AWSPowerShell.NetCore comando. Questo non è necessario per i cmdlet nei moduli AWS.Tools.

Inizializza la tua sessione PowerShell

Quando si avvia PowerShell su un sistema basato su Linux o macOS dopo aver installato il AWS Tools for PowerShell, è necessario eseguire Initialize- AWSDefaultConfiguration per specificare quale chiave di accesso utilizzare. AWS Per ulteriori informazioni su Initialize-AWSDefaultConfiguration, consulta Uso delle credenziali AWS.

Nota

Nelle versioni precedenti (precedenti alla 3.3.96.0) di, questo cmdlet veniva denominato. AWS Tools for PowerShellInitialize-AWSDefaults

Controllo delle versioni

AWS rilascia AWS Tools for PowerShell periodicamente nuove versioni per supportare nuovi servizi e funzionalità. AWS Per determinare la versione di AWS Tools for PowerShell che è stata installata, eseguire il AWSPowerShellVersion cmdlet Get-.

PS > Get-AWSPowerShellVersion

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

Amazon Web Services SDK for .NET
Core Runtime Version 3.3.103.22
Copyright 2009-2015 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]

Per visualizzare un elenco dei AWS servizi supportati nella versione corrente degli strumenti, aggiungere il -ListServiceVersionInfo parametro a un cmdlet Get- AWSPowerShellVersion.

Per determinare la versione in esecuzione, immettere $PSVersionTable per visualizzare il contenuto della variabile $PSVersionTable automatica. PowerShell

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

Aggiornamento di AWS Tools for PowerShell su Linux o macOS

Periodicamente, man mano che AWS Tools for PowerShell vengono rilasciate versioni aggiornate di, è necessario aggiornare la versione in esecuzione localmente.

Aggiorna i moduli modularizzati AWS.Tools

Per aggiornare i AWS.Tools moduli alla versione più recente, esegui il seguente comando:

PS > Update-AWSToolsModule -CleanUp

Questo comando aggiorna tutti i moduli AWS.Tools attualmente installati e, per i moduli che sono stati aggiornati correttamente, rimuove le versioni precedenti.

Nota

Il cmdlet Update-AWSToolsModule scarica tutti i moduli dal PSRepository con nome PSGallery (https://www.powershellgallery.com/) e lo considera un'origine attendibile. Usa il comando Get-PSRepository -Name PSGallery per ulteriori informazioni su PSRepository.

Aggiorna gli strumenti per PowerShell Core

Esegui il Get-AWSPowerShellVersion cmdlet per determinare la versione in esecuzione e confrontala con la versione di Tools for Windows PowerShell disponibile sul sito Web PowerShell Gallery. Consigliamo di controllare ogni due o tre settimane. Il supporto per nuovi comandi e AWS servizi è disponibile solo dopo l'aggiornamento a una versione con tale supporto.

Prima di installare una versione più recente di AWSPowerShell. NetCore, disinstalla il modulo esistente. Chiudi tutte PowerShell le sessioni aperte prima di disinstallare il pacchetto esistente. Per disinstallare il pacchetto, eseguire il comando seguente.

PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

Dopo aver disinstallato il pacchetto, installa il modulo aggiornato eseguendo il comando riportato qui di seguito.

PS > Install-Module -Name AWSPowerShell.NetCore

Dopo l'installazione, esegui il comando Import-Module AWSPowerShell.NetCore per caricare i cmdlet aggiornati nella sessione PowerShell .

Informazioni correlate

• Nozioni di base su AWS Tools for Windows PowerShell

• Lavora con AWS i servizi in AWS Tools for PowerShell