È stata rilasciata la versione 5 (V5) di\$1 AWS Strumenti per PowerShell
Per informazioni sulle modifiche introduttive e sulla migrazione delle applicazioni, consulta l'argomento sulla [migrazione](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)
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Inizia con AWS Strumenti per PowerShell
Negli argomenti seguenti viene illustrato come installare correttamente i AWS Strumenti per PowerShell cmdlet e configurare l'autenticazione con. AWS
**Topics**
+ [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
+ [Installazione su Windows](pstools-getting-set-up-windows.md)
+ [Installazione su Linux o macOS](pstools-getting-set-up-linux-mac.md)
+ [Autenticazione con AWS](creds-idc.md)
# Installato AWS Strumenti per PowerShell su AWS CloudShell
`AWS.Tools`è preinstallato AWS CloudShell come descritto in [Software preinstallato](https://docs.aws.amazon.com/cloudshell/latest/userguide/vm-specs.html#pre-installed-software) nella Guida per l'[AWS CloudShell utente](https://docs.aws.amazon.com/cloudshell/latest/userguide/). Poiché le credenziali della console vengono passate automaticamente a CloudShell, un utente con le autorizzazioni di apertura CloudShell può eseguire immediatamente Tools for PowerShell cmdlet senza ulteriori installazioni o configurazioni.
Per utilizzare l'opzione AWS Strumenti per PowerShell on CloudShell, eseguire passaggi simili ai seguenti:
1. Apri la [CloudShellconsole](https://console.aws.amazon.com/cloudshell/home).
1. Esegui `pwsh`.
1. Esegui tutti `AWS.Tools` PowerShell i comandi di cui hai bisogno, ad esempio`Get-S3Bucket`.
# Installazione di AWS Strumenti per PowerShell su Windows
Per informazioni sugli strumenti PowerShell preinstallati su AWS CloudShell, vedere[Installato su CloudShell](pstools-getting-set-up-cloudshell.md).
Un computer basato su Windows può eseguire qualsiasi opzione del AWS Strumenti per PowerShell pacchetto:
+ [**`AWS.Tools`**](ps-installing-awstools.md)- La versione modulare di. AWS Strumenti per PowerShell Ogni AWS servizio è supportato da un proprio piccolo modulo individuale, con moduli `AWS.Tools.Common` di supporto condivisi e. `AWS.Tools.Installer`
+ [**AWSPowerConchiglia. NetCore**](ps-installing-awspowershellnetcore.md) - La versione a modulo singolo di grandi dimensioni di AWS Strumenti per 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](https://aws.amazon.com/lambda/). Utilizza invece la versione modulare mostrata in precedenza.
+ [**AWSPowerShell**](ps-installing-awswindowspowershell.md): la versione precedente, specifica per Windows, a modulo singolo e di grandi dimensioni di. AWS Strumenti per PowerShell Tutti i AWS servizi sono supportati da questo unico modulo di grandi dimensioni.
Il pacchetto scelto dipende dalla versione e dall'edizione di Windows in esecuzione.
**Nota**
AWS Strumenti per PowerShell Sono installati per impostazione predefinita su tutte le Amazon Machine Images () AMIs basate su Windows. L'opzione installata dipende dall'AMI. Molti AMIs hanno il modulo AWSPower Shell, ma alcuni potrebbero avere un'opzione diversa. Ad esempio, Amazon EC2 AMIs for Windows Server 2025 utilizza l'`AWS.Tools`opzione modulare.
La configurazione di AWS Strumenti per PowerShell prevede le seguenti attività di alto livello, descritte in dettaglio negli argomenti successivi.
1. Installa l'opzione di AWS Strumenti per PowerShell pacchetto appropriata per il tuo ambiente.
1. Verificare che l'esecuzione dello script sia abilitata eseguendo il cmdlet `Get-ExecutionPolicy`.
1. Importa il AWS Strumenti per PowerShell modulo nella tua PowerShell sessione.
## Prerequisiti
Le versioni più recenti di PowerShell, tra cui PowerShell Core, sono disponibili come download da Microsoft all'indirizzo [Installazione di varie versioni del PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) sito Web di Microsoft.
**Topics**
+ [Prerequisiti](#prerequisites)
+ [Installazione `AWS.Tools` (consigliata)](ps-installing-awstools.md)
+ [Installa AWSPower Shell. NetCore](ps-installing-awspowershellnetcore.md)
+ [Installa AWSPower Shell (legacy)](ps-installing-awswindowspowershell.md)
# Installazione `AWS.Tools` su Windows (scelta consigliata)
Per informazioni generali AWS Strumenti per PowerShell sull'installazione di Windows, inclusi i prerequisiti e altre opzioni, consultate l'[argomento principale](pstools-getting-set-up-windows.md).
Per informazioni sugli strumenti PowerShell preinstallati su AWS CloudShell, vedere. [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
È possibile installare la versione modulare di AWS Strumenti per PowerShell su computer che eseguono Windows con Windows PowerShell 5.1 o PowerShell Core 6.0 o versione successiva. Per informazioni su come installare PowerShell Core, vedere [Installazione di varie versioni di PowerShell sul sito Web di](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) 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.Installer`richiede `PowerShellGet` e ne scarica e installa automaticamente una versione aggiornata. `AWS.Tools.Installer`mantiene 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](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)` ed estraendoli in una delle cartelle dei moduli. È possibile scoprire le cartelle dei moduli visualizzando il valore della variabile di ambiente `PSModulePath`.
**avvertimento**
Dopo aver scaricato il file ZIP e prima di estrarne il contenuto, potrebbe essere necessario sbloccarlo. Questa operazione viene in genere eseguita aprendo le proprietà del file, visualizzando la scheda **Generale** e selezionando la casella di controllo **Sblocca**, se presente.
Se il file ZIP deve essere sbloccato ma non lo fai, potresti ricevere errori simili ai seguenti: «Import-Module: Could not load file or assembly».
+ Installazione di ogni modulo di servizio dalla PowerShell Galleria utilizzando il cmdlet. `Install-Module`
**Per l'installazione `AWS.Tools` su Windows utilizzando il modulo `AWS.Tools.Installer`**
1. Avviare una PowerShell sessione.
**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.
1. Per installare il pacchetto `AWS.Tools` suddiviso in moduli, esegui il comando seguente.
```
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 desideri 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 comando con il parametro `-Force`.
```
PS > Install-Module -Name AWS.Tools.Installer -Force
```
1. È ora possibile installare il modulo per ogni AWS servizio che si desidera utilizzare utilizzando il `Install-AWSToolsModule` cmdlet. 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 di AWS 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 `Install-AWSToolsModule` cmdlet scarica tutti i moduli richiesti dal file `PSRepository` denominato `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e lo considera una fonte attendibile. Usa il comando `Get-PSRepository -Name PSGallery` per ulteriori informazioni su `PSRepository`.
Per impostazione predefinita, il comando precedente installa i moduli nella cartella `%USERPROFILE%\Documents\WindowsPowerShell\Modules`. Per installarlo AWS Strumenti per PowerShell per tutti gli utenti di un computer, è necessario eseguire il comando seguente in una PowerShell sessione avviata come amministratore. Ad esempio, il seguente comando installa il modulo IAM nella cartella `%ProgramFiles%\WindowsPowerShell\Modules` che è accessibile a tutti gli utenti.
```
PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers
```
Per installare altri moduli, esegui comandi simili con i nomi dei moduli appropriati, come si trova nella [PowerShell Galleria](https://www.powershellgallery.com/packages?q=aws).
## Abilitazione dell'esecuzione di uno script
Per caricare i AWS Strumenti per PowerShell moduli, è necessario abilitare l'esecuzione degli PowerShell script. Per abilitare l'esecuzione dello script, eseguire il cmdlet `Set-ExecutionPolicy` per impostare una policy `RemoteSigned`. Per ulteriori informazioni, consulta [Informazioni sulle policy di esecuzione](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) sul sito Web Microsoft Technet.
**Nota**
Questo è un requisito solo per i computer che eseguono Windows. La restrizione di sicurezza `ExecutionPolicy` non è presente su altri sistemi operativi.
**Per abilitare l'esecuzione dello script**
1. Per impostare la policy di esecuzione sono necessari i diritti di amministratore. Se non hai effettuato l'accesso come utente con diritti di amministratore, apri una PowerShell sessione come amministratore. Scegli **Start**, quindi seleziona **Tutti i programmi**. Scegli **Accessori**, quindi scegli **Windows PowerShell**. Fate clic con PowerShell il pulsante destro del mouse su **Windows** e nel menu contestuale scegliete **Esegui come amministratore**.
1. Nel prompt dei comandi inserisci quanto segue.
```
PS > Set-ExecutionPolicy RemoteSigned
```
**Nota**
Su un sistema a 64 bit, è necessario eseguire questa operazione separatamente per la versione a 32 bit di PowerShell **Windows PowerShell (x86**).
Se la politica di esecuzione non è impostata correttamente, PowerShell mostra il seguente errore ogni volta che si tenta di eseguire uno script, ad esempio il profilo.
```
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
```
Il programma di PowerShell installazione di Tools for Windows aggiorna automaticamente il [PSModulePath](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_psmodulepath) per includere la posizione della directory che contiene il `AWSPowerShell` modulo.
Poiché `PSModulePath` include la posizione della directory del AWS modulo, il `Get-Module -ListAvailable` cmdlet mostra il modulo.
```
PS > Get-Module -ListAvailable
ModuleType Name ExportedCommands
---------- ---- ----------------
Manifest AppLocker {}
Manifest BitsTransfer {}
Manifest PSDiagnostics {}
Manifest TroubleshootingPack {}
Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...
```
## Controllo delle versioni
AWS rilascia AWS Strumenti per PowerShell periodicamente nuove versioni di per supportare nuovi AWS servizi e funzionalità. Per determinare la versione degli strumenti installata, eseguire il AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Esempio:
```
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]
```
È inoltre possibile aggiungere il `-ListServiceVersionInfo` parametro a un AWSPower ShellVersion comando [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) per visualizzare un elenco dei AWS servizi supportati nella versione corrente degli strumenti. Se utilizzi l'opzione `AWS.Tools.*` suddivisa in moduli, vengono visualizzati solo i moduli attualmente importati.
Esempio:
```
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
...
```
Per determinare la versione PowerShell che stai utilizzando, inserisci `$PSVersionTable` per visualizzare il contenuto della [variabile automatica](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) \$1 PSVersion Table.
Esempio:
```
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 Strumenti per PowerShell su Windows
Periodicamente, man mano che AWS Strumenti per PowerShell vengono rilasciate versioni aggiornate di, è necessario aggiornare la versione in esecuzione localmente.
### Aggiornate i moduli modulari `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 `AWS.Tools` moduli attualmente installati e, dopo un aggiornamento riuscito, rimuove le versioni precedenti.
**Nota**
Il `Update-AWSToolsModule` cmdlet scarica tutti i moduli dal file `PSRepository` denominato `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e lo considera una fonte attendibile. Utilizzare il `Get-PSRepository -Name PSGallery` comando per ulteriori informazioni al riguardo. `PSRepository`
# Installa AWSPower Shell. NetCore su Windows
Per informazioni generali AWS Strumenti per PowerShell sull'installazione di in Windows, inclusi i prerequisiti e altre opzioni, vedere l'[argomento principale](pstools-getting-set-up-windows.md).
Per informazioni sugli strumenti PowerShell preinstallati su AWS CloudShell, vedere. [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
**Nota**
AWSPowerConchiglia. NetCore non è il metodo consigliato per l'installazione di AWS Strumenti per PowerShell. Per il metodo consigliato, vedi [Installazione `AWS.Tools` (consigliata)](ps-installing-awstools.md) invece.
È possibile installare la AWSPower Shell. NetCore su computer che eseguono Windows con PowerShell versioni da 3 a 5.1 oppure PowerShell Core 6.0 o versioni successive. Per informazioni su come installare PowerShell Core, vedi [Installazione di varie versioni PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell) sul PowerShell sito Web di Microsoft.
È possibile installare AWSPower Shell. NetCore in due modi
+ Scaricamento del modulo da [AWSPowerShell. NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip) ed estraendolo in una delle directory del modulo. Puoi individuare le directory dei moduli visualizzando il valore della variabile di ambiente `PSModulePath`.
**avvertimento**
Dopo aver scaricato il file ZIP e prima di estrarne il contenuto, potrebbe essere necessario sbloccarlo. Questa operazione viene in genere eseguita aprendo le proprietà del file, visualizzando la scheda **Generale** e selezionando la casella di controllo **Sblocca**, se presente.
Se il file ZIP deve essere sbloccato ma non lo fai, potresti ricevere errori simili ai seguenti: «Import-Module: Could not load file or assembly».
+ Installazione dalla PowerShell Galleria utilizzando il `Install-Module` cmdlet, come descritto nella procedura seguente.
**Per installare Shell AWSPower. NetCore dalla PowerShell Galleria utilizzando il cmdlet Install-Module**
Per installare Shell. AWSPower NetCore dalla PowerShell Galleria, sul computer deve essere installata la PowerShell versione 5.0 o versione successiva oppure la versione PowerShell 3 o versione successiva. [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet) Esegui il comando seguente.
```
PS > Install-Module -name AWSPowerShell.NetCore
```
Se si esegue PowerShell come amministratore, il comando precedente viene installato AWS Strumenti per PowerShell per tutti gli utenti del computer. Se si esegue PowerShell come utente standard senza autorizzazioni di amministratore, lo stesso comando viene installato solo AWS Strumenti per PowerShell per l'utente corrente.
Per effettuare l'installazione solo per l'utente corrente quando tale utente dispone delle autorizzazioni di amministratore, esegui il comando con il set di parametri `-Scope CurrentUser`, come indicato di seguito.
```
PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser
```
Sebbene la PowerShell versione 3.0 e le versioni successive in genere carichino i moduli nella PowerShell sessione la prima volta che si esegue un cmdlet nel modulo Shell. AWSPower NetCore il modulo è troppo grande per supportare questa funzionalità. È invece necessario caricare esplicitamente la AWSPower Shell. NetCore Modulo principale nella PowerShell sessione eseguendo il comando seguente.
```
PS > Import-Module AWSPowerShell.NetCore
```
Per caricare la AWSPower Shell. NetCore inserisci automaticamente il modulo in una PowerShell sessione, aggiungi quel comando al tuo PowerShell profilo. Per ulteriori informazioni sulla modifica del PowerShell profilo, consulta [About Profiles](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles) nella PowerShell documentazione.
## Abilitazione dell'esecuzione di uno script
Per caricare i AWS Strumenti per PowerShell moduli, è necessario abilitare l'esecuzione degli PowerShell script. Per abilitare l'esecuzione dello script, eseguire il cmdlet `Set-ExecutionPolicy` per impostare una policy `RemoteSigned`. Per ulteriori informazioni, consulta [Informazioni sulle policy di esecuzione](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) sul sito Web Microsoft Technet.
**Nota**
Questo è un requisito solo per i computer che eseguono Windows. La restrizione di sicurezza `ExecutionPolicy` non è presente su altri sistemi operativi.
**Per abilitare l'esecuzione dello script**
1. Per impostare la policy di esecuzione sono necessari i diritti di amministratore. Se non hai effettuato l'accesso come utente con diritti di amministratore, apri una PowerShell sessione come amministratore. Scegli **Start**, quindi seleziona **Tutti i programmi**. Scegli **Accessori**, quindi scegli **Windows PowerShell**. Fate clic con PowerShell il pulsante destro del mouse su **Windows** e nel menu contestuale scegliete **Esegui come amministratore**.
1. Nel prompt dei comandi inserisci quanto segue.
```
PS > Set-ExecutionPolicy RemoteSigned
```
**Nota**
Su un sistema a 64 bit, è necessario eseguire questa operazione separatamente per la versione a 32 bit di PowerShell **Windows PowerShell (x86**).
Se la politica di esecuzione non è impostata correttamente, PowerShell mostra il seguente errore ogni volta che si tenta di eseguire uno script, ad esempio il profilo.
```
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
```
Il programma di PowerShell installazione di Tools for Windows aggiorna automaticamente il [PSModulePath](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_psmodulepath) per includere la posizione della directory che contiene il `AWSPowerShell` modulo.
Poiché `PSModulePath` include la posizione della directory del AWS modulo, il `Get-Module -ListAvailable` cmdlet mostra il modulo.
```
PS > Get-Module -ListAvailable
ModuleType Name ExportedCommands
---------- ---- ----------------
Manifest AppLocker {}
Manifest BitsTransfer {}
Manifest PSDiagnostics {}
Manifest TroubleshootingPack {}
Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...
```
## Controllo delle versioni
AWS rilascia AWS Strumenti per PowerShell periodicamente nuove versioni di per supportare nuovi AWS servizi e funzionalità. Per determinare la versione degli strumenti installata, eseguire il AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Per esempio:
```
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]
```
È inoltre possibile aggiungere il `-ListServiceVersionInfo` parametro a un AWSPower ShellVersion comando [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) per visualizzare un elenco dei AWS servizi supportati nella versione corrente degli strumenti. Se utilizzi l'opzione `AWS.Tools.*` suddivisa in moduli, vengono visualizzati solo i moduli attualmente importati.
Per esempio:
```
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
...
```
Per determinare la versione PowerShell che stai utilizzando, inserisci `$PSVersionTable` per visualizzare il contenuto della [variabile automatica](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) \$1 PSVersion Table.
Per esempio:
```
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 Strumenti per PowerShell su Windows
Periodicamente, man mano che AWS Strumenti per PowerShell vengono rilasciate versioni aggiornate di, è necessario aggiornare la versione in esecuzione localmente.
### 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](https://www.powershellgallery.com/packages/AWSPowerShell). 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 AWSPower Shell. 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 .
# Installare AWSPower Shell su Windows PowerShell (versione precedente)
Per informazioni generali AWS Strumenti per PowerShell sull'installazione di in Windows, inclusi i prerequisiti e altre opzioni, consultate l'[argomento principale](pstools-getting-set-up-windows.md).
Per informazioni sugli strumenti PowerShell preinstallati su AWS CloudShell, vedere. [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
**Nota**
AWSPowerShell non è il metodo consigliato per l' AWS Strumenti per PowerShell installazione di. Per il metodo consigliato, vedi [Installazione `AWS.Tools` (consigliata)](ps-installing-awstools.md) invece.
Puoi installarlo AWS Tools for Windows PowerShell in due modi:
+ Scaricando il modulo da [AWSPowerShell.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.zip) ed estraendolo in una delle directory del modulo. Puoi individuare le directory dei moduli visualizzando il valore della variabile di ambiente `PSModulePath`.
**avvertimento**
Dopo aver scaricato il file ZIP e prima di estrarne il contenuto, potrebbe essere necessario sbloccarlo. Questa operazione viene in genere eseguita aprendo le proprietà del file, visualizzando la scheda **Generale** e selezionando la casella di controllo **Sblocca**, se presente.
Se il file ZIP deve essere sbloccato ma non lo fai, potresti ricevere errori simili ai seguenti: «Import-Module: Could not load file or assembly».
+ Installazione dalla PowerShell Galleria utilizzando il `Install-Module` cmdlet come descritto nella procedura seguente.
**Per installare AWSPower Shell dalla PowerShell Gallery utilizzando il cmdlet Install-Module**
È possibile installare AWSPower Shell dalla PowerShell Galleria se si esegue la PowerShell versione 5.0 o successiva oppure se è stata installata [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet)la versione 3 o successiva. PowerShell È possibile installare e aggiornare AWSPower Shell dalla [PowerShellGalleria](https://www.powershellgallery.com/packages/AWSPowerShell) di Microsoft eseguendo il comando seguente.
```
PS > Install-Module -Name AWSPowerShell
```
Per caricare automaticamente il modulo AWSPower Shell in una PowerShell sessione, aggiungi il `import-module` cmdlet precedente al tuo PowerShell profilo. Per ulteriori informazioni sulla modifica del PowerShell profilo, vedere [Informazioni sui profili](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6) nella PowerShell documentazione.
## Abilitazione dell'esecuzione di uno script
Per caricare i AWS Strumenti per PowerShell moduli, è necessario abilitare l'esecuzione degli PowerShell script. Per abilitare l'esecuzione dello script, eseguire il cmdlet `Set-ExecutionPolicy` per impostare una policy `RemoteSigned`. Per ulteriori informazioni, consulta [Informazioni sulle policy di esecuzione](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies) sul sito Web Microsoft Technet.
**Nota**
Questo è un requisito solo per i computer che eseguono Windows. La restrizione di sicurezza `ExecutionPolicy` non è presente su altri sistemi operativi.
**Per abilitare l'esecuzione dello script**
1. Per impostare la policy di esecuzione sono necessari i diritti di amministratore. Se non hai effettuato l'accesso come utente con diritti di amministratore, apri una PowerShell sessione come amministratore. Scegli **Start**, quindi seleziona **Tutti i programmi**. Scegli **Accessori**, quindi scegli **Windows PowerShell**. Fate clic con PowerShell il pulsante destro del mouse su **Windows** e nel menu contestuale scegliete **Esegui come amministratore**.
1. Nel prompt dei comandi inserisci quanto segue.
```
PS > Set-ExecutionPolicy RemoteSigned
```
**Nota**
Su un sistema a 64 bit, è necessario eseguire questa operazione separatamente per la versione a 32 bit di PowerShell **Windows PowerShell (x86**).
Se la politica di esecuzione non è impostata correttamente, PowerShell mostra il seguente errore ogni volta che si tenta di eseguire uno script, ad esempio il profilo.
```
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
```
Il programma di PowerShell installazione di Tools for Windows aggiorna automaticamente il [PSModulePath](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_psmodulepath) per includere la posizione della directory che contiene il `AWSPowerShell` modulo.
Poiché `PSModulePath` include la posizione della directory del AWS modulo, il `Get-Module -ListAvailable` cmdlet mostra il modulo.
```
PS > Get-Module -ListAvailable
ModuleType Name ExportedCommands
---------- ---- ----------------
Manifest AppLocker {}
Manifest BitsTransfer {}
Manifest PSDiagnostics {}
Manifest TroubleshootingPack {}
Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...
```
## Controllo delle versioni
AWS rilascia AWS Strumenti per PowerShell periodicamente nuove versioni di per supportare nuovi AWS servizi e funzionalità. Per determinare la versione degli strumenti installata, eseguire il AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Esempio:
```
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]
```
È inoltre possibile aggiungere il `-ListServiceVersionInfo` parametro a un AWSPower ShellVersion comando [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) per visualizzare un elenco dei AWS servizi supportati nella versione corrente degli strumenti. Se utilizzi l'opzione `AWS.Tools.*` suddivisa in moduli, vengono visualizzati solo i moduli attualmente importati.
Esempio:
```
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
...
```
Per determinare la versione PowerShell che stai utilizzando, inserisci `$PSVersionTable` per visualizzare il contenuto della [variabile automatica](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6) \$1 PSVersion Table.
Esempio:
```
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 Strumenti per PowerShell su Windows
Periodicamente, man mano che AWS Strumenti per PowerShell vengono rilasciate versioni aggiornate di, è necessario aggiornare la versione in esecuzione localmente.
### Aggiorna gli strumenti per Windows PowerShell
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](https://www.powershellgallery.com/packages/AWSPowerShell). 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.
+ Se hai effettuato l'installazione utilizzando il cmdlet `Install-Module`, esegui il comando riportato qui di seguito.
```
PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell
```
+ Se hai effettuato l'installazione utilizzando un file ZIP scaricato:
1. Scarica la versione più recente dal sito PowerShell Web [Tools for](https://aws.amazon.com/powershell/). Confronta il numero di versione del pacchetto nel nome del file scaricato con il numero di versione visualizzato quando esegui il cmdlet `Get-AWSPowerShellVersion`.
1. Se il numero della versione scaricata è superiore a quello della versione installata, chiudi tutti gli strumenti per le PowerShell console Windows.
1. Installa la versione più recente degli strumenti per Windows. PowerShell
Dopo l'installazione, `Import-Module AWSPowerShell` esegui per caricare i cmdlet aggiornati nella sessione. PowerShell Oppure esegui la AWS Strumenti per PowerShell console personalizzata dal menu **Start**.
# Installazione AWS Strumenti per PowerShell su Linux o macOS
Per informazioni sugli strumenti preinstallati su AWS CloudShell, consulta. PowerShell [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
Per l'installazione AWS Strumenti per PowerShell su un computer Linux o macOS, puoi scegliere tra due opzioni di pacchetto:
+ [**`AWS.Tools`**](install-aws.tools-on-linux-macos.md)— La versione modulare di. AWS Strumenti per PowerShell Ogni AWS servizio è supportato da un proprio piccolo modulo individuale, con moduli di supporto condivisi. `AWS.Tools.Common`
+ [**AWSPowerConchiglia. NetCore**](install-netcore-on-linux-macos.md) — La versione a modulo singolo di grandi dimensioni di AWS Strumenti per 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](https://aws.amazon.com/lambda/). Utilizza invece la versione modulare mostrata in precedenza.
La configurazione di una di queste opzioni su un computer che esegue Linux o macOS comporta le seguenti attività, descritte in dettaglio negli argomenti successivi:
1. Installa PowerShell Core 6.0 o versione successiva su un sistema supportato.
1. Dopo aver installato PowerShell Core, inizia PowerShell eseguendolo `pwsh` nella shell del sistema.
1. Installa una delle due `AWS.Tools` o AWSPower Shell. NetCore.
1. Esegui il `Import-Module` cmdlet appropriato per importare il modulo nella sessione PowerShell.
1. Esegui il cmdlet [Initialize- AWSDefault Configuration per fornire le](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) 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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-linux) 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](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell-core-on-macos) di Microsoft.
**Topics**
+ [Prerequisiti](#prerequisites)
+ [Installazione `AWS.Tools` (consigliata)](install-aws.tools-on-linux-macos.md)
+ [Installa AWSPower Shell. NetCore](install-netcore-on-linux-macos.md)
# Installazione `AWS.Tools` su Linux o macOS (consigliata)
[Per informazioni generali sull'installazione di AWS Strumenti per PowerShell su Linux o macOS, inclusi i prerequisiti e altre opzioni, consulta l'argomento principale.](pstools-getting-set-up-linux-mac.md)
Per informazioni sugli strumenti preinstallati su AWS CloudShell, vedere. PowerShell [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
È possibile installare la versione modulare di AWS Strumenti per PowerShell su computer che eseguono PowerShell Core 6.0 o versione successiva. Per informazioni su come installare PowerShell Core, vedi [Installazione di varie versioni PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-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.Installer`richiede `PowerShellGet` e ne scarica e installa automaticamente una versione aggiornata. `AWS.Tools.Installer`mantiene 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](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/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.
1. 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 ti viene comunicato che il repository è «non affidabile», ti viene chiesto se desideri comunque installarlo. 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
```
1. 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`. Questo è un modulo condiviso richiesto da tutti i moduli di servizio AWS . 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 `Install-AWSToolsModule` cmdlet scarica tutti i moduli richiesti dal file `PSRepository` denominato `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e considera il repository come una fonte 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](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-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](https://www.powershellgallery.com/packages?q=aws).
## Esecuzione di uno script
Il comando `Set-ExecutionPolicy` non è disponibile sui sistemi non Windows. Puoi eseguire`Get-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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1) 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…
```
## Inizializza la sessione PowerShell
Quando si avvia PowerShell su un sistema basato su Linux o macOS dopo aver installato il AWS Strumenti per PowerShell, è necessario eseguire [Initialize- AWSDefault Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) per specificare la chiave di accesso da utilizzare. AWS Per ulteriori informazioni su `Initialize-AWSDefaultConfiguration`, consultare [Utilizzo delle AWS credenziali](specifying-your-aws-credentials.md).
**Nota**
Nelle versioni precedenti (precedenti alla 3.3.96.0) di, questo cmdlet era denominato. AWS Strumenti per PowerShell`Initialize-AWSDefaults`
## Controllo delle versioni
AWS rilascia AWS Strumenti per PowerShell periodicamente nuove versioni per supportare nuovi servizi e funzionalità. AWS Per determinare la versione di AWS Strumenti per PowerShell che è stata installata, eseguire il AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Esempio:
```
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]
```
Per visualizzare un elenco dei AWS servizi supportati nella versione corrente degli strumenti, aggiungere il `-ListServiceVersionInfo` parametro a un cmdlet [Get- AWSPower ShellVersion](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Per determinare la versione in esecuzione, immettere `$PSVersionTable` per visualizzare il contenuto della variabile `$PSVersionTable` [automatica](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6). PowerShell
Esempio:
```
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 Strumenti per PowerShell su Linux o macOS
Periodicamente, man mano che AWS Strumenti per PowerShell vengono rilasciate versioni aggiornate di, è necessario aggiornare la versione in esecuzione localmente.
### Aggiornate i moduli modulari `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 `AWS.Tools` moduli attualmente installati e, dopo un aggiornamento riuscito, rimuove le versioni precedenti.
**Nota**
Il `Update-AWSToolsModule` cmdlet scarica tutti i moduli dal file `PSRepository` denominato `PSGallery` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) e lo considera una fonte attendibile. Utilizzare il `Get-PSRepository -Name PSGallery` comando per ulteriori informazioni al riguardo. `PSRepository`
## Informazioni correlate
+ [Configurazione e utilizzo di AWS Strumenti per PowerShell](pstools-getting-started.md)
+ [AWS Servizi di chiamata in AWS Strumenti per PowerShell](pstools-using.md)
# Installa AWSPower Shell. NetCore su Linux o macOS
[Per informazioni generali sull'installazione di AWS Strumenti per PowerShell su Linux o macOS, inclusi i prerequisiti e altre opzioni, consulta l'argomento principale.](pstools-getting-set-up-linux-mac.md)
Per informazioni sugli strumenti preinstallati su AWS CloudShell, vedere. PowerShell [Installato su CloudShell](pstools-getting-set-up-cloudshell.md)
**Nota**
AWSPowerConchiglia. NetCore non è il metodo consigliato per l'installazione di AWS Strumenti per PowerShell. Per il metodo consigliato, vedi [Installazione `AWS.Tools` (consigliata)](install-aws.tools-on-linux-macos.md) invece.
Per eseguire l'aggiornamento a una versione più recente di AWSPower Shell. NetCore, segui le istruzioni riportate in[Aggiornamento di AWS Strumenti per PowerShell su Linux o macOS](#pstools-updating-linux-netcore). Disinstalla le versioni precedenti di AWSPower Shell. NetCore prima.
Puoi installare AWSPower Shell. NetCore in due modi:
+ Scaricando il modulo da `[AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/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 Shell AWSPower. 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 la AWSPower Shell. 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 ti viene comunicato che il repository è «non affidabile», ti viene chiesto se desideri comunque installarlo. Inserisci **y** per consentire l' PowerShell 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 utente root, a meno che non si desideri installarlo AWS Strumenti per PowerShell per tutti gli utenti di un computer. Per fare ciò, esegui il comando seguente in una PowerShell sessione con cui hai iniziato`sudo 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 eseguire`Get-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](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1) sul sito Web Microsoft Technet.
Poiché `PSModulePath` include la posizione della directory del AWS modulo, il `Get-Module -ListAvailable` cmdlet mostra il modulo installato.
**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 AWSPower Shell. NetCore a causa delle sue grandi dimensioni. Per iniziare a eseguire AWSPower Shell. 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 Strumenti per PowerShell, è necessario eseguire [Initialize- AWSDefault Configuration](https://docs.aws.amazon.com/powershell/v5/reference/items/Initialize-AWSDefaultConfiguration.html) per specificare la chiave di accesso da utilizzare. AWS Per ulteriori informazioni su `Initialize-AWSDefaultConfiguration`, consultare [Utilizzo delle AWS credenziali](specifying-your-aws-credentials.md).
**Nota**
Nelle versioni precedenti (precedenti alla 3.3.96.0) di, questo cmdlet era denominato. AWS Strumenti per PowerShell`Initialize-AWSDefaults`
## Controllo delle versioni
AWS rilascia AWS Strumenti per PowerShell periodicamente nuove versioni per supportare nuovi servizi e funzionalità. AWS Per determinare la versione di AWS Strumenti per PowerShell che è stata installata, eseguire il AWSPower ShellVersion cmdlet [Get-](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Esempio:
```
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]
```
Per visualizzare un elenco dei AWS servizi supportati nella versione corrente degli strumenti, aggiungere il `-ListServiceVersionInfo` parametro a un cmdlet [Get- AWSPower ShellVersion](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html).
Per determinare la versione in esecuzione, immettere `$PSVersionTable` per visualizzare il contenuto della variabile `$PSVersionTable` [automatica](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6). PowerShell
Esempio:
```
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 Strumenti per PowerShell su Linux o macOS
Periodicamente, man mano che AWS Strumenti per PowerShell vengono rilasciate versioni aggiornate di, è necessario aggiornare la versione in esecuzione localmente.
### 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](https://www.powershellgallery.com/packages/AWSPowerShell). 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 AWSPower Shell. 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
+ [Configurazione e utilizzo di AWS Strumenti per PowerShell](pstools-getting-started.md)
+ [AWS Servizi di chiamata in AWS Strumenti per PowerShell](pstools-using.md)
# Autenticazione con AWS Strumenti per PowerShell AWS
È necessario stabilire in che modo il codice si autentica durante lo sviluppo con AWS . Servizi AWS Esistono diversi modi in cui è possibile configurare l'accesso programmatico alle AWS risorse, a seconda dell'ambiente e dell' AWS accesso a disposizione.
Per visualizzare i vari metodi di autenticazione per Tools for PowerShell, consulta [Autenticazione e accesso](https://docs.aws.amazon.com/sdkref/latest/guide/access.html) nella *Guida di riferimento agli strumenti AWS SDKs e agli strumenti*.
In questo argomento si presuppone che un nuovo utente stia sviluppando localmente, non abbia ricevuto un metodo di autenticazione dal datore di lavoro e che lo utilizzerà AWS IAM Identity Center per ottenere credenziali temporanee. Se l'ambiente in uso non rientra in questi presupposti, alcune delle informazioni contenute in questo argomento potrebbero non riguardarti l'utente o potrebbero esserti già state fornite.
La configurazione di questo ambiente richiede diversi passaggi, riassunti di seguito:
1. [Accedi utilizzando le credenziali della console](#login-con-creds)
1. [Abilitazione e configurazione di IAM Identity Center](#idc-config-sso)
1. [Configura gli strumenti per PowerShell utilizzare IAM Identity Center.](#idc-config-sdk)
1. [Avviare una sessione del portale di AWS accesso](#idc-start-portal)
## Accedi utilizzando le credenziali della console
È possibile utilizzare le credenziali di accesso esistenti AWS della Console di gestione per l'accesso programmatico a. Servizi AWS Dopo un flusso di autenticazione basato su browser, AWS Strumenti per PowerShell genera credenziali temporanee che funzionano con strumenti di sviluppo locali come, and. AWS SDKs AWS Strumenti per PowerShell AWS CLI Questa funzionalità semplifica il processo di configurazione e gestione delle credenziali CLI, soprattutto se si preferisce l'autenticazione interattiva alla gestione delle chiavi di accesso a lungo termine.
Con questo processo, puoi autenticarti utilizzando le credenziali root create durante la configurazione iniziale dell'account, un utente IAM o un'identità federata del tuo provider di identità e Tools for gestisce PowerShell automaticamente le credenziali temporanee per te. Questo approccio migliora la sicurezza eliminando la necessità di archiviare le credenziali a lungo termine a livello locale.
Quando si esegue il `Invoke-AWSLogin` cmdlet, è possibile selezionare una delle sessioni attive della console oppure accedere tramite il flusso di autenticazione basato sul browser e questo genererà automaticamente credenziali temporanee. AWS Strumenti per PowerShell aggiornerà automaticamente queste credenziali per un massimo di 12 ore.
Una volta configurata, la sessione può essere utilizzata in AWS Strumenti per PowerShell e in tutti gli altri strumenti AWS SDKs .
### Prerequisiti
+ Accesso per accedere alla console di AWS gestione come utente root, utente IAM o tramite federazione con IAM. Se utilizzi IAM Identity Center, vai [Configura gli strumenti per PowerShell utilizzare IAM Identity Center.](#idc-config-sdk) invece a.
+ Assicurati che l'identità IAM disponga delle autorizzazioni appropriate. Allega la policy [SignInLocalDevelopmentAccess](https://docs.aws.amazon.com/signin/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-SignInLocalDevelopmentAccess)gestita al tuo utente, ruolo o gruppo IAM. Se accedi come utente root, non sono richieste autorizzazioni aggiuntive.
### Accedere a AWS con il cmdlet Invoke- AWSLogin
Esegui il `Invoke-AWSLogin` cmdlet per l'autenticazione utilizzando le credenziali della console di gestione esistenti. AWS Se non hai configurato in precedenza un profilo, ti verranno richieste ulteriori informazioni.
Per accedere o configurare un profilo, procedi nel seguente modo.
1. Assicurati di aver importato il modulo corretto che hai installato dalla guida all'installazione.
**Nota**
Abbiamo tre diversi moduli per PowerShell -`AWS.Tools`, `AWSPowerShell.NetCore` e`AWSPowerShell`. Per ulteriori informazioni, consulta [Cosa sono gli AWS Strumenti per PowerShell?](pstools-welcome.md).
+ Nel PowerShell terminale, esegui il cmdlet. Verrà utilizzato il profilo. `default`
```
PS > Invoke-AWSLogin
```
+ Per accedere a un profilo denominato o crearne uno nuovo, usa il `-ProfileName` parametro.
```
PS > Invoke-AWSLogin -ProfileName 'my-dev-profile'
```
+ Se si tratta di un nuovo profilo o se non è Regione AWS stato specificato o configurato in nessuna delle profiles/environment variabili precedenti, il cmdlet richiede di fornire un'area.
```
Press Ctrl+C to cancel the following login prompts.
Specify AWS Region
No AWS region has been configured. The AWS region is the geographic location of your AWS resources.
If you've used AWS before and already have resources in your account, tell us which region they were created in. If you
haven't created resources in your account before, you can pick the region closest to you:
https://docs.aws.amazon.com/global-infrastructure/latest/regions/aws-regions.html
AWS Region:
```
1. I AWS Strumenti per PowerShell tentativi di aprire il browser predefinito per la procedura di accesso all'account. AWS
```
Using region 'us-west-2'
Attempting to open the login page for 'us-west-2' in your default browser.
If the browser does not open, use the following URL to complete your login:
https://signin.us-west-2.amazonaws.com/authorize?
If you cannot connect to this URL, make sure that you have specified a valid region.
```
+ Se il dispositivo utilizzato AWS Strumenti per PowerShell non dispone di un browser, puoi utilizzare il `-Remote` parametro per fornire un URL da aprire su un dispositivo abilitato al browser.
```
PS > Invoke-AWSLogin -Remote
```
+ Se hai utilizzato il `-Remote` parametro, vengono visualizzate le istruzioni per avviare manualmente la procedura di accesso in base al tipo di autorizzazione che stai utilizzando. L'URL visualizzato è un URL univoco che inizia con: https://signin.us-east-1.amazonaws.com /authorize. Una volta completato l'accesso al browser, dovrai copiare e incollare nuovamente il codice di autorizzazione risultante nel terminale.
```
Press Ctrl+C to cancel the following login prompts.
Using region 'us-west-2' determined by profile/environment defaults. To override, specify '-Region' parameter.
Please complete the login workflow via the following URL:
https://us-west-2.signin.aws.amazon.com/v1/authorize?
Please enter the authorization code displayed in the browser:
```
1. Nel browser, selezionate le credenziali da utilizzare dall'elenco visualizzato e poi tornate al terminale.
+ Se il profilo che state configurando ha una sessione di accesso precedentemente configurata che non corrisponde alla nuova sessione, vi viene AWS Strumenti per PowerShell richiesto di confermare che state cambiando la sessione che corrisponde al profilo esistente.
```
WARNING: Previously profile default was configured for arn:aws:iam::0123456789012:user/ReadOnly,
and is now being updated to arn:aws:iam::0123456789012:user/Admin.
Do you wish to change the identity that default is associated with? (y/n)
```
1. Un messaggio finale descrive la configurazione del profilo completata.
```
Login completed successfully for profile 'my-dev-profile'.
```
Il token di autenticazione viene memorizzato nella cache su disco sotto il. aws/login/cachedirectory con un nome di file hash basato sul profilo risolto.
#### File di configurazione generato
Questi passaggi comportano la creazione del profilo predefinito o specificato nel file di configurazione simile al seguente:
```
[default]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1
[my-dev-profile]
login_session = arn:aws:iam::0123456789012:user/username
region = us-east-1
```
#### Esegui un comando con il tuo profilo
Una volta effettuato l'accesso, è possibile utilizzare le credenziali per richiamare Tools for PowerShell cmdlet con il profilo associato. L'esempio seguente chiama il `Get-STSCallerIdentity` cmdlet utilizzando il profilo predefinito:
```
PS > Get-STSCallerIdentity
```
Per verificare la presenza di una sessione specifica, utilizzare il `-ProfileName` parametro.
```
PS > Get-STSCallerIdentity -ProfileName 'my-dev-profile'
```
Il token di credenziali temporaneo scadrà tra 15 minuti, ma lo AWS Strumenti per PowerShell SDKs aggiornerà automaticamente quando necessario durante le richieste. L'intera sessione sarà valida per un massimo di 12 ore, dopodiché sarà necessario eseguire nuovamente il `Invoke-AWSLogin` cmdlet.
#### Uscire dalla sessione utilizzando il cmdlet `Invoke-AWSLogout`
Al termine della sessione, è possibile lasciare scadere le credenziali oppure eseguire il `Invoke-AWSLogout` cmdlet per eliminare le credenziali memorizzate nella cache. Se non viene specificato alcun profilo nella CLI o nella variabile di AWS\$1PROFILE ambiente, il comando esclude il profilo predefinito. L'esempio seguente ti disconnette dal tuo profilo predefinito.
```
PS > Invoke-AWSLogout
```
Per uscire da una sessione di profilo specifica, utilizzate il `-ProfileName` parametro.
```
PS > Invoke-AWSLogout -ProfileName 'my-dev-profile'
```
Per uscire da tutte le sessioni del profilo a cui hai effettuato l'accesso, usa il `-All` parametro.
```
PS > Invoke-AWSLogout -All
```
#### Credenziali memorizzate nella cache
Le credenziali temporanee memorizzate nella cache e i metadati necessari per aggiornarle vengono archiviati per impostazione predefinita `%USERPROFILE%\.aws\login\cache` in Windows o `~/.aws/login/cache` Linux e macOS.
È possibile sovrascrivere questa posizione impostando la variabile di ambiente. `AWS_LOGIN_CACHE_DIRECTORY`
## Abilitazione e configurazione di IAM Identity Center
Per utilizzarla AWS IAM Identity Center, deve prima essere abilitata e configurata. Per maggiori dettagli su come eseguire questa operazione PowerShell, consulta la **Fase 1** dell'argomento relativo all'[autenticazione di IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) nella *AWS SDKs and Tools Reference Guide*. In particolare, segui le istruzioni necessarie riportate nella sezione **I do not have established access through IAM Identity Center** (Non ho stabilito l'accesso tramite IAM Identity Center).
## Configura gli strumenti per PowerShell utilizzare IAM Identity Center.
**Nota**
A partire dalla versione 4.1.538 di Tools for PowerShell, il metodo consigliato per configurare le credenziali SSO e avviare una sessione del portale di AWS accesso consiste nell'utilizzare i [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin)cmdlet [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration)and, come descritto in questo argomento. Se non si ha accesso a quella versione degli strumenti per PowerShell (o successiva) o non è possibile utilizzare tali cmdlet, è comunque possibile eseguire queste attività utilizzando il. AWS CLI Per scoprire come, vedi. [Usa il AWS CLI per accedere al portale](creds-idc-cli.md)
La procedura seguente aggiorna il AWS `config` file condiviso con le informazioni SSO che Tools for PowerShell utilizza per ottenere credenziali temporanee. Come conseguenza di questa procedura, viene avviata anche una sessione del portale di AWS accesso. Se il `config` file condiviso contiene già informazioni SSO e desideri semplicemente sapere come avviare una sessione del portale di accesso utilizzando gli Strumenti per PowerShell, consulta la sezione successiva di questo argomento,[Avviare una sessione del portale di AWS accesso](#idc-start-portal).
1. Se non l'hai ancora fatto, apri PowerShell e installa il file appropriato per AWS Strumenti per PowerShell il tuo sistema operativo e ambiente, inclusi i cmdlet comuni. Per informazioni su come eseguire questa attività, consultare [Inizia con AWS Strumenti per PowerShell](pstools-getting-set-up.md).
Ad esempio, se installi la versione modulare di Tools for PowerShell on Windows, molto probabilmente eseguirai comandi simili ai seguenti:
```
Install-Module -Name AWS.Tools.Installer
Install-AWSToolsModule AWS.Tools.Common
```
1. Eseguire il seguente comando seguente. Sostituisci i valori delle proprietà di esempio con i valori della configurazione di IAM Identity Center. Per informazioni su queste proprietà e su come trovarle, consulta le [impostazioni del provider di credenziali IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/feature-sso-credentials.html#feature-sso-credentials-profile) nella *AWS SDKs and Tools Reference Guide*.
```
$params = @{
ProfileName = 'my-sso-profile'
AccountId = '111122223333'
RoleName = 'SamplePermissionSet'
SessionName = 'my-sso-session'
StartUrl = 'https://provided-domain.awsapps.com/start'
SSORegion = 'us-west-2'
RegistrationScopes = 'sso:account:access'
};
Initialize-AWSSSOConfiguration @params
```
In alternativa, è possibile utilizzare semplicemente il cmdlet da solo e la `Initialize-AWSSSOConfiguration` finestra Tools for PowerShell richiede i valori delle proprietà.
Considerazioni per determinati valori di proprietà:
+ Se hai semplicemente seguito le istruzioni per [abilitare e configurare IAM Identity Center](#idc-config-sso), il valore per `-RoleName` potrebbe essere`PowerUserAccess`. Ma se hai creato un set di autorizzazioni IAM Identity Center appositamente per PowerShell il lavoro, utilizzalo invece.
+ Assicurati di utilizzare il Regione AWS punto in cui hai configurato IAM Identity Center.
1. A questo punto, il AWS `config` file condiviso contiene un profilo chiamato `my-sso-profile` con un set di valori di configurazione a cui è possibile fare riferimento negli Strumenti per PowerShell. Per trovare la posizione di questo file, consulta [Posizione dei file condivisi nella](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Guida di riferimento agli strumenti AWS SDKs e strumenti*.
Tools for PowerShell utilizza il provider di token SSO del profilo per acquisire le credenziali prima di inviare richieste a. AWS Il `sso_role_name` valore, che è un ruolo IAM connesso a un set di autorizzazioni IAM Identity Center, dovrebbe consentire l'accesso ai dati Servizi AWS utilizzati nell'applicazione.
L'esempio seguente mostra il profilo che è stato creato utilizzando il comando mostrato sopra. Alcuni valori delle proprietà e il relativo ordine potrebbero essere diversi nel profilo attuale. La `sso-session` proprietà del profilo si riferisce alla sezione denominata`my-sso-session`, che contiene le impostazioni per avviare una sessione del portale di AWS accesso.
```
[profile my-sso-profile]
sso_account_id=111122223333
sso_role_name=SamplePermissionSet
sso_session=my-sso-session
[sso-session my-sso-session]
sso_region=us-west-2
sso_registration_scopes=sso:account:access
sso_start_url=https://provided-domain.awsapps.com/start/
```
1. Se hai già una sessione attiva del portale di AWS accesso, la sezione Strumenti ti PowerShell informa che hai già effettuato l'accesso.
In caso contrario, la sezione Strumenti PowerShell tenta di aprire automaticamente la pagina di autorizzazione SSO nel browser Web predefinito. Segui le istruzioni del tuo browser, che potrebbero includere un codice di autorizzazione SSO, nome utente e password e l'autorizzazione ad accedere agli AWS IAM Identity Center account e ai set di autorizzazioni.
Gli strumenti per PowerShell informarti che l'accesso SSO è avvenuto con successo.
## Avviare una sessione del portale di AWS accesso
Prima di eseguire i comandi di accesso Servizi AWS, è necessaria una sessione attiva del portale di AWS accesso in modo che Tools for PowerShell possa utilizzare l'autenticazione IAM Identity Center per risolvere le credenziali. Per accedere al portale di AWS accesso, esegui il seguente comando in PowerShell, `-ProfileName my-sso-profile` dov'è il nome del profilo che è stato creato nel `config` file condiviso quando hai seguito la procedura nella sezione precedente di questo argomento.
```
Invoke-AWSSSOLogin -ProfileName my-sso-profile
```
Se hai già una sessione attiva del portale di AWS accesso, il menu Strumenti ti PowerShell informa che hai già effettuato l'accesso.
In caso contrario, la sezione Strumenti PowerShell tenta di aprire automaticamente la pagina di autorizzazione SSO nel browser Web predefinito. Segui le istruzioni del tuo browser, che potrebbero includere un codice di autorizzazione SSO, nome utente e password e l'autorizzazione ad accedere agli AWS IAM Identity Center account e ai set di autorizzazioni.
Gli strumenti per PowerShell informarti che l'accesso SSO è avvenuto con successo.
Per verificare se hai già una sessione attiva, esegui il comando seguente dopo aver installato o importato il `AWS.Tools.SecurityToken` modulo, se necessario.
```
Get-STSCallerIdentity -ProfileName my-sso-profile
```
La risposta al `Get-STSCallerIdentity` cmdlet riporta l'account IAM Identity Center e il set di autorizzazioni configurati nel file condiviso. `config`
## Esempio
Di seguito è riportato un esempio di come utilizzare IAM Identity Center con gli strumenti per. PowerShell Si presume quanto segue:
+ Hai abilitato IAM Identity Center e lo hai configurato come descritto in questo argomento. Le proprietà SSO si trovano nel `my-sso-profile` profilo, configurato in precedenza in questo argomento.
+ Quando accedi tramite i `Invoke-AWSSSOLogin` cmdlet `Initialize-AWSSSOConfiguration` or, l'utente dispone almeno delle autorizzazioni di sola lettura per Amazon S3.
+ Alcuni bucket S3 sono disponibili per la visualizzazione da parte dell'utente.
Installa o importa il `AWS.Tools.S3` modulo secondo necessità, quindi utilizza il PowerShell comando seguente per visualizzare un elenco dei bucket S3.
```
Get-S3Bucket -ProfileName my-sso-profile
```
## Informazioni aggiuntive
+ Per ulteriori opzioni sull'autenticazione per gli strumenti per PowerShell, come l'uso di profili e variabili di ambiente, consulta il capitolo sulla [configurazione](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) nella Guida di *riferimento agli strumenti AWS SDKs e agli strumenti*.
+ Alcuni comandi richiedono la specificazione di una AWS regione. Esistono diversi modi per farlo, tra cui l'opzione del `-Region` cmdlet, il `[default]` profilo e la variabile di `AWS_REGION` ambiente. Per ulteriori informazioni, vedere [Specificare la AWS regione per AWS Strumenti per PowerShell](pstools-installing-specifying-region.md) in questa guida e [AWS Region nella AWS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) *SDKs and Tools Reference* Guide.
+ Per ulteriori informazioni sulle best practice, consulta [Best practice per la sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l'utente di IAM*.
+ Per creare AWS credenziali a breve termine, consulta [Temporary Security Credentials](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) nella *IAM User Guide*.
+ *Per ulteriori informazioni su altri fornitori di credenziali, consulta Provider di [credenziali standardizzati nella and Tools Reference](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Guide AWS SDKs .*
**Topics**
+ [Accedi utilizzando le credenziali della console](#login-con-creds)
+ [Abilitazione e configurazione di IAM Identity Center](#idc-config-sso)
+ [Configura gli strumenti per PowerShell utilizzare IAM Identity Center.](#idc-config-sdk)
+ [Avviare una sessione del portale di AWS accesso](#idc-start-portal)
+ [Esempio](#idc-short-example)
+ [Informazioni aggiuntive](#idc-additional-info)
+ [Usa il AWS CLI](creds-idc-cli.md)
# Usa il AWS CLI per accedere al portale
A partire dalla versione 4.1.538 di Tools for PowerShell, il metodo consigliato per configurare le credenziali SSO e avviare una sessione del portale di AWS accesso consiste nell'utilizzare i [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Invoke-AWSSSOLogin.html&tocid=Invoke-AWSSSOLogin)cmdlet [https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Initialize-AWSSSOConfiguration.html&tocid=Initialize-AWSSSOConfiguration)and, come descritto in. [Autenticazione con AWS Strumenti per PowerShell AWS](creds-idc.md) Se non si ha accesso a quella versione di Tools for PowerShell (o successiva) o non è possibile utilizzare tali cmdlet, è comunque possibile eseguire queste attività utilizzando il. AWS CLI
## Configura gli strumenti per PowerShell utilizzare IAM Identity Center tramite. AWS CLI
Se non l'hai già fatto, assicurati di [abilitare e configurare IAM Identity Center](creds-idc.md#idc-config-sso) prima di procedere.
Le informazioni su come configurare gli strumenti PowerShell per utilizzare IAM Identity Center tramite IAM sono riportate nella **Fase 2** dell'argomento relativo all'[autenticazione di IAM Identity Center](https://docs.aws.amazon.com/sdkref/latest/guide/access-sso.html) nella *Guida di riferimento agli strumenti AWS SDKs e agli strumenti*. AWS CLI Dopo aver completato questa configurazione, il sistema deve contenere i seguenti elementi:
+ Il AWS CLI, che viene utilizzato per avviare una sessione del portale di AWS accesso prima di eseguire l'applicazione.
+ Il AWS `config` file condiviso che contiene un [`[default]`profilo](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) con un set di valori di configurazione a cui è possibile fare riferimento negli Strumenti per PowerShell. Per trovare la posizione di questo file, consulta [Posizione dei file condivisi nella](https://docs.aws.amazon.com/sdkref/latest/guide/file-location.html) *Guida di riferimento agli strumenti AWS SDKs e strumenti*. The Tools for PowerShell utilizza il provider di token SSO del profilo per acquisire le credenziali prima di inviare richieste a. AWS Il `sso_role_name` valore, che è un ruolo IAM connesso a un set di autorizzazioni IAM Identity Center, dovrebbe consentire l'accesso ai dati Servizi AWS utilizzati nell'applicazione.
Il seguente `config` file di esempio mostra un `[default]` profilo configurato con un provider di token SSO. L'impostazione `sso_session` del profilo si riferisce alla sezione `sso-session` denominata. La `sso-session` sezione contiene le impostazioni per avviare una sessione del portale di AWS accesso.
```
[default]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole
region = us-east-1
output = json
[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://provided-domain.awsapps.com/start
sso_registration_scopes = sso:account:access
```
**Importante**
La PowerShell sessione deve avere i seguenti moduli installati e importati in modo che la risoluzione SSO possa funzionare:
`AWS.Tools.SSO`
`AWS.Tools.SSOOIDC`
Se utilizzi una versione precedente di Tools for PowerShell e non disponi di questi moduli, riceverai un errore simile al seguente: «Assembly AWSSDK .SSOOIDC could not be found...».
## Avvia una sessione del portale di accesso AWS
Prima di eseguire i comandi di accesso Servizi AWS, è necessaria una sessione attiva del portale di AWS accesso in modo che Tools for Windows PowerShell possa utilizzare l'autenticazione IAM Identity Center per risolvere le credenziali. A seconda della durata della sessione configurata, l'accesso alla fine scadrà e gli Strumenti per Windows PowerShell riscontreranno un errore di autenticazione. Per accedere al portale di AWS accesso, esegui il seguente comando in. AWS CLI
```
aws sso login
```
Poiché si utilizza il `[default]` profilo, non è necessario richiamare il comando con l'`--profile`opzione. Se la configurazione del provider di token SSO utilizza un profilo denominato, il comando è `aws sso login --profile named-profile` invece. Per ulteriori informazioni sui profili denominati, consulta la sezione [Profili](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) nella *Guida di riferimento agli strumenti AWS SDKs e agli strumenti*.
Per verificare se hai già una sessione attiva, esegui il AWS CLI comando seguente (con la stessa considerazione per named profile):
```
aws sts get-caller-identity
```
La risposta a questo comando dovrebbe restituire l'account IAM Identity Center e il set di autorizzazioni configurati nel file `config` condiviso.
**Nota**
Se hai già una sessione attiva del portale di AWS accesso ed esegui`aws sso login`, non ti verrà richiesto di fornire credenziali.
La procedura di accesso potrebbe richiedere all'utente di consentire l' AWS CLI accesso ai dati. Poiché AWS CLI è basato sull'SDK per Python, i messaggi di autorizzazione possono contenere variazioni del `botocore` nome.
## Esempio
Di seguito è riportato un esempio di come utilizzare IAM Identity Center con gli strumenti per. PowerShell Si presume quanto segue:
+ Hai abilitato IAM Identity Center e lo hai configurato come descritto in questo argomento. Le proprietà SSO si trovano nel profilo `[default]`.
+ Quando accedi tramite AWS CLI by using`aws sso login`, quell'utente dispone almeno delle autorizzazioni di sola lettura per Amazon S3.
+ Alcuni bucket S3 sono disponibili per la visualizzazione da parte dell'utente.
Usa i seguenti PowerShell comandi per visualizzare un elenco dei bucket S3:
```
Install-Module AWS.Tools.Installer
Install-AWSToolsModule S3
# And if using an older version of the AWS Tools for PowerShell:
Install-AWSToolsModule SSO, SSOOIDC
# In older versions of the AWS Tools for PowerShell, we're not invoking a cmdlet from these modules directly,
# so we must import them explicitly:
Import-Module AWS.Tools.SSO
Import-Module AWS.Tools.SSOOIDC
# Older versions of the AWS Tools for PowerShell don't support the SSO login flow, so login with the CLI
aws sso login
# Now we can invoke cmdlets using the SSO profile
Get-S3Bucket
```
Come accennato in precedenza, poiché si utilizza il `[default]` profilo, non è necessario chiamare il `Get-S3Bucket` cmdlet con l'opzione. `-ProfileName` Se la configurazione del provider di token SSO utilizza un profilo denominato, il comando è `Get-S3Bucket -ProfileName named-profile`. Per ulteriori informazioni sui profili denominati, vedere la sezione [Profili](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html#file-format-profile) nella Guida di *riferimento agli strumenti AWS SDKs e agli strumenti.*
## Informazioni aggiuntive
+ Per ulteriori opzioni sull'autenticazione per gli Strumenti per PowerShell, come l'uso di profili e variabili di ambiente, consultate il capitolo sulla [configurazione](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) nella *Guida di riferimento agli strumenti AWS SDKs e agli strumenti*.
+ Alcuni comandi richiedono la specificazione di una AWS regione. Esistono diversi modi per farlo, tra cui l'opzione del `-Region` cmdlet, il `[default]` profilo e la variabile di `AWS_REGION` ambiente. Per ulteriori informazioni, vedere [Specificare la AWS regione per AWS Strumenti per PowerShell](pstools-installing-specifying-region.md) in questa guida e [AWS Region nella AWS](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) *SDKs and Tools Reference* Guide.
+ Per ulteriori informazioni sulle best practice, consulta [Best practice per la sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) nella *Guida per l'utente di IAM*.
+ Per creare AWS credenziali a breve termine, consulta [Temporary Security Credentials](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) nella *IAM User Guide*.
+ *Per ulteriori informazioni su altri fornitori di credenziali, consulta Provider di [credenziali standardizzati nella and Tools Reference](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html) Guide AWS SDKs .*