La version 5 (V5) du Outils AWS pour PowerShell est sortie \$1

Pour plus d'informations sur les modifications majeures et la migration de vos applications, consultez la [rubrique relative à la migration](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).

 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)

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

# Spécifiez AWS la région pour Outils AWS pour PowerShell
<a name="pstools-installing-specifying-region"></a>

Il existe deux manières de spécifier la AWS région à utiliser lors de l'exécution de Outils AWS pour PowerShell commandes :
+ Utilisez le paramètre commun `-Region` pour les commandes individuelles.
+ Utilisez la commande `Set-DefaultAWSRegion` pour définir une région par défaut pour toutes les commandes.

De nombreuses AWS applets de commande échouent si les Outils pour Windows ne PowerShell parviennent pas à déterminer la région à utiliser. Les exceptions incluent les applets de commande pour [Amazon S3](pstools-s3.md), Amazon SES et Amazon Gestion des identités et des accès AWS, qui utilisent automatiquement par défaut un point de terminaison global.

 **Pour spécifier la région pour une seule AWS commande** 

Ajoutez le paramètre `-Region` à votre commande, par exemple :

```
PS > Get-EC2Image -Region us-west-2
```

 **Pour définir une région par défaut pour toutes les commandes AWS CLI de la session en cours** 

À partir de l'invite de PowerShell commande, tapez la commande suivante.

```
PS > Set-DefaultAWSRegion -Region us-west-2
```

**Note**  
Cette valeur n'est valable que pour la session en cours. Pour appliquer le paramètre à toutes vos PowerShell sessions, ajoutez cette commande à votre PowerShell profil comme vous l'avez fait pour la `Import-Module` commande.

 **Pour afficher la région par défaut actuelle pour toutes les commandes de la AWS CLI** 

À partir de l'invite de PowerShell commande, tapez la commande suivante.

```
PS > Get-DefaultAWSRegion

Region    Name             IsShellDefault
------    ----             --------------
us-west-2 US West (Oregon) True
```

 **Pour effacer la région par défaut actuelle pour toutes les commandes de la AWS CLI** 

À partir de l'invite de PowerShell commande, tapez la commande suivante.

```
PS > Clear-DefaultAWSRegion
```

 **Pour consulter la liste de toutes les AWS régions disponibles** 

À partir de l'invite de PowerShell commande, tapez la commande suivante. Notez que la troisième colonne identifie la région par défaut de votre session en cours.

```
PS > Get-AWSRegion

Region         Name                      IsShellDefault
------         ----                      --------------
ap-east-1      Asia Pacific (Hong Kong)  False
ap-northeast-1 Asia Pacific (Tokyo)      False
...
us-east-2      US East (Ohio)            False
us-west-1      US West (N. California)   False
us-west-2      US West (Oregon)          True
...
```

**Note**  
Certaines régions peuvent être prises en charge, mais elles ne sont pas incluses dans les résultats de l'applet de commande `Get-AWSRegion`. Par exemple, c'est parfois le cas des régions qui ne sont pas encore à l'échelle mondiale. Si vous ne pouvez pas spécifier une région en ajoutant le paramètre `-Region`, essayez plutôt d'indiquer la région dans un point de terminaison personnalisé, comme indiqué dans la section suivante.

## Spécification d'un point de terminaison personnalisé ou non standard
<a name="specifying-a-custom-or-nonstandard-endpoint"></a>

Spécifiez un point de terminaison personnalisé sous forme d'URL en ajoutant le paramètre `-EndpointUrl` commun à votre PowerShell commande Outils pour Windows, dans le format d'exemple suivant.

```
PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters
```

Voici un exemple de commande à l'aide de l'applet de commande `Get-EC2Instance`. Le point de terminaison personnalisé se trouve dans la région `us-west-2` ou US West (Oregon) dans cet exemple, mais vous pouvez utiliser n'importe quelle autre région AWS prise en charge, y compris les régions qui ne sont pas répertoriées par `Get-AWSRegion`.

```
PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"
```

## Informations supplémentaires
<a name="region-additional-info"></a>

Pour plus d'informations sur AWS les régions, consultez [AWS la section Région](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) dans le *guide de référence des outils AWS SDKs et des outils*.