A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](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)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando o ClientConfig parâmetro em cmdlets
<a name="pstools-clientconfig"></a>

O parâmetro `ClientConfig` pode ser usado para especificar determinadas configurações quando você se conecta a um serviço. A maioria das propriedades possíveis desse parâmetro é definida na [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, que é herdada em APIs for AWS services. Para obter um exemplo de herança simples, veja a 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). Além disso, alguns serviços definem propriedades adicionais que são apropriadas somente para esse serviço. Para ver um exemplo de propriedades adicionais que foram definidas, consulte a 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), especificamente a propriedade `ForcePathStyle`.

## Usar o parâmetro `ClientConfig`
<a name="clientconfig-operation"></a>

Para usar o `ClientConfig` parâmetro, você pode especificá-lo na linha de comando como um `ClientConfig` objeto ou usar o PowerShell splatting para passar uma coleção de valores de parâmetros para um comando como uma unidade. Esses métodos são mostrados nos exemplos a seguir. Os exemplos pressupõem que o módulo `AWS.Tools.S3` tenha sido instalado e importado e que você tenha um perfil de credenciais `[default]` com as permissões apropriadas.

******Definir um objeto `ClientConfig`**

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

**Adicionar `ClientConfig` propriedades usando PowerShell respingos**

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

Get-S3Object @params
```

## Usar uma propriedade indefinida
<a name="clientconfig-undefined"></a>

Ao usar o PowerShell splatting, se você especificar uma `ClientConfig` propriedade que não existe, ela Ferramentas da AWS para PowerShell não detectará o erro até o tempo de execução, quando retornará uma exceção. Modificação do exemplo acima:

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

Get-S3Object @params
```

Esse exemplo gerará uma exceção semelhante à seguinte:

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

## Especificando o Região da AWS
<a name="clientconfig-region"></a>

Você pode usar o `ClientConfig` parâmetro para definir o Região da AWS para o comando. A região é definida por meio da propriedade `RegionEndpoint`. O Ferramentas da AWS para PowerShell calcula a região a ser usada de acordo com a seguinte precedência:

1. O parâmetro `-Region`

1. A região transmitida no parâmetro `ClientConfig`

1. O estado PowerShell da sessão

1. O AWS `config` arquivo compartilhado

1. As variáveis de ambiente

1. Os metadados da EC2 instância da Amazon, se habilitados.