AWS -Tools für PowerShell V4 ist in den Wartungsmodus gewechselt.

Wir empfehlen Ihnen, auf [AWS -Tools für PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/) zu migrieren. Weitere Einzelheiten und Informationen zur Migration finden Sie in unserer [Ankündigung zum Wartungsmodus](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# AWS Regionen angeben
<a name="pstools-installing-specifying-region"></a>

Es gibt zwei Möglichkeiten, die AWS Region anzugeben, die bei der Ausführung von AWS -Tools für PowerShell Befehlen verwendet werden soll:
+ Verwenden Sie den allgemeinen Parameter `-Region` für einzelne Befehle.
+ Verwenden Sie den Befehl `Set-DefaultAWSRegion`, um eine Standardregion für alle Befehle festzulegen.

Viele AWS Cmdlets schlagen fehl, wenn die Tools für Windows nicht herausfinden PowerShell können, welche Region verwendet werden soll. Zu den Ausnahmen gehören Cmdlets für [Amazon S3](pstools-s3.md), Amazon SES und AWS Identity and Access Management, die automatisch standardmäßig einen globalen Endpunkt verwenden.

 **Um die Region für einen einzelnen Befehl anzugeben AWS ** 

Fügen Sie den Parameter `-Region` zu Ihrem Befehl hinzu, zum Beispiel folgendermaßen.

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

 **So legen Sie eine Standardregion für alle AWS CLI-Befehle in der aktuellen Sitzung fest** 

Geben Sie in der PowerShell Befehlszeile den folgenden Befehl ein.

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

**Anmerkung**  
Diese Einstellung bleibt nur für die aktuelle Sitzung bestehen. Um die Einstellung auf alle Ihre PowerShell Sitzungen anzuwenden, fügen Sie diesen Befehl Ihrem PowerShell Profil hinzu, wie Sie es für den `Import-Module` Befehl getan haben.

 **So zeigen Sie die aktuelle Standardregion für alle AWS CLI-Befehle an** 

Geben Sie in der PowerShell Befehlszeile den folgenden Befehl ein.

```
PS > Get-DefaultAWSRegion

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

 **Um die aktuelle Standardregion für alle AWS CLI-Befehle zu löschen** 

Geben Sie in der PowerShell Befehlszeile den folgenden Befehl ein.

```
PS > Clear-DefaultAWSRegion
```

 **Um eine Liste aller verfügbaren AWS Regionen anzuzeigen** 

Geben Sie in der PowerShell Befehlszeile den folgenden Befehl ein. Die dritte Spalte in der Beispielausgabe gibt an, welche Region die Standardeinstellung für Ihre aktuelle Sitzung ist.

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

**Anmerkung**  
Einige Regionen werden möglicherweise unterstützt, sind jedoch nicht in den Ausgaben des Cmdlets `Get-AWSRegion` enthalten. Dies gilt beispielsweise manchmal für Regionen, die noch nicht global sind. Wenn Sie eine Region nicht angeben können, indem Sie den Parameter `-Region` zu einem Befehl hinzufügen, geben Sie die Region stattdessen in einem benutzerdefinierten Endpunkt an, wie im folgenden Abschnitt gezeigt.

## Angeben eines benutzerdefinierten oder nicht standardmäßigen Endpunkts
<a name="specifying-a-custom-or-nonstandard-endpoint"></a>

Geben Sie einen benutzerdefinierten Endpunkt als URL an, indem Sie Ihrem PowerShell Befehl Tools für Windows den `-EndpointUrl` gemeinsamen Parameter im folgenden Beispielformat hinzufügen.

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

Im Folgenden finden Sie ein Beispiel für die Verwendung des `Get-EC2Instance`-Cmdlets. Der benutzerdefinierte Endpunkt ist in diesem Beispiel in `us-west-2` oder USA West (Oregon), aber Sie können auch jede andere unterstützte AWS -Region verwenden, einschließlich solcher Regionen, die nicht von `Get-AWSRegion` aufgezählt werden.

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

## Zusätzliche Informationen
<a name="region-additional-info"></a>

Weitere Informationen zu AWS Regionen finden Sie unter [AWS Region](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) im Referenzhandbuch *AWS SDKs und im Tools-Referenzhandbuch*.