Outils AWS pour PowerShell La V4 est passée en mode maintenance.

Nous vous recommandons de migrer vers la [Outils AWS pour PowerShell version 5](https://docs.aws.amazon.com/powershell/v5/userguide/). Pour plus de détails et d'informations sur la façon de migrer, veuillez consulter notre [annonce relative au mode de maintenance](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation du ClientConfig paramètre dans les applets de commande
<a name="pstools-clientconfig"></a>

Le paramètre `ClientConfig` permet de spécifier certains paramètres de configuration lorsque vous vous connectez à un service. La plupart des propriétés possibles de ce paramètre sont définies dans la [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, qui est héritée dans les AWS services APIs for. Pour un exemple d'héritage simple, consultez la 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). En outre, certains services définissent des propriétés supplémentaires qui ne sont appropriées que pour ce service. Pour obtenir un exemple de propriétés définies supplémentaires, consultez la 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), plus précisément la propriété `ForcePathStyle`.

## Utilisation du paramètre `ClientConfig`
<a name="clientconfig-operation"></a>

Pour utiliser le `ClientConfig` paramètre, vous pouvez le spécifier sur la ligne de commande sous forme d'`ClientConfig`objet ou utiliser le PowerShell splatting pour transmettre une collection de valeurs de paramètres à une commande sous forme d'unité. Ces méthodes sont présentées dans les exemples suivants. Les exemples supposent que le module `AWS.Tools.S3` a été installé et importé, et que vous disposez d'un profil d'informations d'identification `[default]` avec les autorisations appropriées.

******Définition d'un objet `ClientConfig`**

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

**Ajout de `ClientConfig` propriétés à l'aide d' PowerShelléclaboussures**

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

Get-S3Object @params
```

## Utilisation d'une propriété non définie
<a name="clientconfig-undefined"></a>

Lorsque vous utilisez le PowerShell splatting, si vous spécifiez une `ClientConfig` propriété qui n'existe pas, elle Outils AWS pour PowerShell ne détecte pas l'erreur avant l'exécution, date à laquelle elle renvoie une exception. En modifiant l'exemple ci-dessus :

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

Get-S3Object @params
```

Cet exemple produit une exception semblable à la suivante :

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

## Spécifier le Région AWS
<a name="clientconfig-region"></a>

Vous pouvez utiliser le `ClientConfig` paramètre Région AWS pour définir la commande. La région est définie à travers la propriété `RegionEndpoint`. Outils AWS pour PowerShell Calcule la région à utiliser en fonction de la priorité suivante :

1. Paramètre `-Region`

1. Région transmise dans le paramètre `ClientConfig`

1. État de PowerShell la session

1. Le AWS `config` fichier partagé

1. Variables d'environnement

1. Les métadonnées de l' EC2 instance Amazon, si elles sont activées.