Angeben von AWS Regionen - AWS Tools for PowerShell
Angeben eines benutzerdefinierten oder nicht standardmäßigen EndpunktsZusätzliche Informationen

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.

Angeben von AWS Regionen

Es gibt zwei Möglichkeiten, die AWS Region anzugeben, die beim Ausführen von AWS Tools for 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 for Windows nicht herausfinden PowerShell können, welche Region verwendet werden soll. Ausnahmen sind Cmdlets für Amazon S3, Amazon SES und AWS Identity and Access Management, die automatisch auf einen globalen Endpunkt festgelegt sind.

So geben Sie die Region für einen einzelnen AWS Befehl an

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 Eingabeaufforderung 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 Eingabeaufforderung den folgenden Befehl ein.

PS > Get-DefaultAWSRegion

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

So löschen Sie die aktuelle Standardregion für alle AWS CLI-Befehle

Geben Sie in der PowerShell Eingabeaufforderung den folgenden Befehl ein.

PS > Clear-DefaultAWSRegion

So zeigen Sie eine Liste aller verfügbaren AWS Regionen an

Geben Sie in der PowerShell Eingabeaufforderung 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

Geben Sie einen benutzerdefinierten Endpunkt als URL an, indem Sie den -EndpointUrl allgemeinen Parameter im folgenden Beispielformat zu Ihrem PowerShell Befehl Tools for Windows 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

Weitere Informationen zu - AWS Regionen finden Sie unter AWS Region im AWS Referenzhandbuch zu -SDKs und Tools.