AWS Strumenti per PowerShell La V4 è entrata in modalità manutenzione.

[Ti consigliamo di migrare alla AWS Strumenti per PowerShell versione V5.](https://docs.aws.amazon.com/powershell/v5/userguide/) Per ulteriori dettagli e informazioni su come eseguire la migrazione, consulta il nostro annuncio sulla modalità di [manutenzione](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).

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à.

# Utilizzo del ClientConfig parametro nei cmdlet
<a name="pstools-clientconfig"></a>

Il parametro `ClientConfig` può essere usato per specificare determinate impostazioni di configurazione durante la connessione a un servizio. La maggior parte delle possibili proprietà di questo parametro sono definite nella [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html)classe, che viene ereditata dai AWS servizi APIs for. Per un esempio di ereditarietà semplice, fai riferimento alla classe [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html). Inoltre, alcuni servizi definiscono proprietà aggiuntive che sono appropriate solo per il servizio specifico. Per un esempio di definizione di proprietà aggiuntive, fai riferimento alla classe [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html) e in particolare alla proprietà `ForcePathStyle`.

## Uso del parametro `ClientConfig`
<a name="clientconfig-operation"></a>

Per utilizzare il `ClientConfig` parametro, è possibile specificarlo nella riga di comando come `ClientConfig` oggetto o utilizzare PowerShell splatting per passare una raccolta di valori di parametro a un comando come unità. Questi metodi vengono mostrati negli esempi seguenti. Gli esempi presuppongono che sia stato installato e importato il modulo `AWS.Tools.S3` e che tu abbia un profilo di credenziali `[default]` con le autorizzazioni appropriate.

******Definizione di un oggetto `ClientConfig`**

```
$s3Config = New-Object -TypeName Amazon.S3.AmazonS3Config
$s3Config.ForcePathStyle = $true
$s3Config.Timeout = [TimeSpan]::FromMilliseconds(150000)
Get-S3Object -BucketName <BUCKET_NAME> -ClientConfig $s3Config
```

**Aggiungere `ClientConfig` proprietà utilizzando lo splatting PowerShell**

```
$params=@{
    ClientConfig=@{
        ForcePathStyle=$true
        Timeout=[TimeSpan]::FromMilliseconds(150000)
    }
    BucketName="<BUCKET_NAME>"
}

Get-S3Object @params
```

## Uso di una proprietà non definita
<a name="clientconfig-undefined"></a>

Quando si utilizza lo PowerShell splatting, se si specifica una `ClientConfig` proprietà che non esiste, l'errore AWS Strumenti per PowerShell viene rilevato solo in fase di esecuzione, momento in cui restituisce un'eccezione. Modificando l'esempio precedente:

```
$params=@{
    ClientConfig=@{
        ForcePathStyle=$true
        UndefinedProperty="Value"
        Timeout=[TimeSpan]::FromMilliseconds(150000)
    }
    BucketName="<BUCKET_NAME>"
}

Get-S3Object @params
```

Questo esempio genera un'eccezione simile alla seguente:

```
Cannot bind parameter 'ClientConfig'. Cannot create object of type "Amazon.S3.AmazonS3Config". The UndefinedProperty property was not found for the Amazon.S3.AmazonS3Config object.
```

## Specificando il Regione AWS
<a name="clientconfig-region"></a>

È possibile utilizzare il `ClientConfig` parametro Regione AWS per impostare il comando. La regione viene impostata tramite la proprietà `RegionEndpoint`. AWS Strumenti per PowerShell calcola la regione da utilizzare in base alla seguente precedenza:

1. Parametro `-Region`

1. Regione passata nel parametro `ClientConfig`

1. Lo stato della sessione PowerShell 

1. Il AWS `config` file condiviso

1. Variabili di ambiente

1. I metadati dell' EC2 istanza Amazon, se abilitati.