Herramientas de AWS para PowerShell La V4 ha entrado en modo de mantenimiento.

Le recomendamos que migre a la [Herramientas de AWS para PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Para obtener información y detalles adicionales sobre cómo realizar la migración, consulta nuestro [anuncio sobre el modo de mantenimiento](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Uso del parámetro ClientConfig en los cmdlets
<a name="pstools-clientconfig"></a>

El parámetro `ClientConfig` se puede usar para especificar ciertos parámetros de configuración cuando se conecta a un servicio. La mayoría de las propiedades posibles de este parámetro están definidas en la clase [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html), que se hereda en las API de los servicios de AWS. Para ver un ejemplo de herencia simple, consulte la clase [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html). Además, algunos servicios definen propiedades adicionales que solo son apropiadas para ese servicio. Para ver un ejemplo de las propiedades adicionales que se han definido, consulte la clase [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html), específicamente la propiedad `ForcePathStyle`.

## Uso del parámetro `ClientConfig`
<a name="clientconfig-operation"></a>

Para usar el parámetro `ClientConfig`, puede especificarlo en la línea de comandos como un objeto `ClientConfig` o usar el método splatting de PowerShell para pasar una colección de valores de parámetros a un comando como una unidad. Estos métodos se muestran en los siguientes ejemplos. En los ejemplos se supone que el módulo `AWS.Tools.S3` se ha instalado e importado y que tiene un perfil de credenciales `[default]` con los permisos adecuados.

******Definición de un objeto `ClientConfig`**

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

**Cómo agregar propiedades `ClientConfig` mediante el uso del método splatting de PowerShell**

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

Get-S3Object @params
```

## Uso de una propiedad indefinida
<a name="clientconfig-undefined"></a>

Al utilizar PowerShell Splatting, si especifica una propiedad `ClientConfig` que no existe, Herramientas de AWS para PowerShell no detectará el error hasta el tiempo de ejecución, momento en el que devolverá una excepción. Modificación del ejemplo anterior:

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

Get-S3Object @params
```

En este ejemplo se produce una excepción similar a la siguiente:

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

## Especificación de la Región de AWS
<a name="clientconfig-region"></a>

Puede usar el parámetro `ClientConfig` para establecer la Región de AWS para el comando. La región se establece mediante la propiedad `RegionEndpoint`. Herramientas de AWS para PowerShell calcula la región que se utilizará de acuerdo con la siguiente prioridad:

1. Parámetro `-Region`

1. Región incluida en el parámetro `ClientConfig`

1. Estado de sesión de PowerShell

1. Archivo `config` de AWS compartido

1. Variables de entorno

1. Metadatos de la instancia de Amazon EC2, si están activados.