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.

# Verwenden des ClientConfig Parameters in Cmdlets
<a name="pstools-clientconfig"></a>

Mit dem `ClientConfig`-Parameter können bestimmte Konfigurationseinstellungen angegeben werden, wenn Sie eine Verbindung zu einem Service herstellen. Die meisten möglichen Eigenschaften dieses Parameters sind in der [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html)Klasse definiert, die an die AWS For-Dienste vererbt wird. APIs Ein Beispiel für einfache Vererbung finden Sie in der [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html)-Klasse. Darüber hinaus definieren einige Services zusätzliche Eigenschaften, die nur für diesen Service geeignet sind. Ein Beispiel für zusätzliche Eigenschaften, die definiert wurden, finden Sie in der [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html)-Klasse, insbesondere in der `ForcePathStyle`-Eigenschaft.

## Verwenden des `ClientConfig`-Parameters
<a name="clientconfig-operation"></a>

Um den `ClientConfig` Parameter zu verwenden, können Sie ihn in der Befehlszeile als `ClientConfig` Objekt angeben oder mithilfe von PowerShell Splatting eine Sammlung von Parameterwerten als Einheit an einen Befehl übergeben. Diese Methoden werden im folgenden Beispiel verdeutlicht. In den Beispielen wird davon ausgegangen, dass das `AWS.Tools.S3`-Modul installiert und importiert wurde und dass Sie über ein `[default]`-Anmeldeinformationsprofil mit entsprechenden Berechtigungen verfügen.

******Definieren eines `ClientConfig`-Objekts**

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

**Hinzufügen von `ClientConfig` Eigenschaften mithilfe PowerShell von Splatting**

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

Get-S3Object @params
```

## Verwenden einer undefinierten Eigenschaft
<a name="clientconfig-undefined"></a>

Wenn Sie bei der Verwendung PowerShell von Splatting eine `ClientConfig` Eigenschaft angeben, die nicht existiert, wird der AWS -Tools für PowerShell Fehler erst zur Laufzeit erkannt. Zu diesem Zeitpunkt wird eine Ausnahme zurückgegeben. Ändern des obigen Beispiels:

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

Get-S3Object @params
```

In diesem Beispiel wird eine Ausnahme in etwa wie folgt erstellt:

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

## Spezifizieren der AWS-Region
<a name="clientconfig-region"></a>

Sie können den `ClientConfig` Parameter verwenden, um den AWS-Region für den Befehl festzulegen. Die Region wird über die `RegionEndpoint`-Eigenschaft festgelegt. Der AWS -Tools für PowerShell berechnet die zu verwendende Region anhand der folgenden Rangfolge:

1. Der `-Region`-Parameter

1. Die Region, die im `ClientConfig`-Parameter übergeben wurde

1. Der PowerShell Sitzungsstatus

1. Die gemeinsam genutzte AWS `config` Datei

1. Die Umgebungsvariablen

1. Die EC2 Amazon-Instance-Metadaten, falls aktiviert.