¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del!

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

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

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 Amazon.Runtime.ClientConfig, que se hereda en las API de los servicios de AWS. Para ver un ejemplo de herencia simple, consulte la clase Amazon.Keyspaces.AmazonKeyspacesConfig. 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 Amazon.S3.AmazonS3Config, específicamente la propiedad ForcePathStyle.

Uso del parámetro ClientConfig

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

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

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: