Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 cmd ClientConfig let 中使用参数

当您连接到某个服务时，ClientConfig 参数可用于指定某些配置设置。此参数的大多数可能属性都是在类中定义的，该Amazon.Runtime.ClientConfig类继承到 for serv Amazon ices 中。 APIs 有关简单继承的示例，请参阅 Amazon.Keyspaces.AmazonKeyspacesConfig 类。此外，一些服务定义了仅适用于该服务的附加属性。有关已定义的其他属性的示例，请参阅 Amazon.S3.AmazonS3Config 类，特别是 ForcePathStyle 属性。

使用 ClientConfig 参数

要使用该ClientConfig参数，可以在命令行上将其指定为ClientConfig对象，也可以使用 PowerShell splatting 将一组参数值作为一个单元传递给命令。以下示例中显示了这些方法。这些示例假设已安装并导入 AWS.Tools.S3 模块，并且您拥有具有适当权限的 [default] 凭据配置文件。

定义一个 ClientConfig 对象

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

使用 PowerShell飞溅添加ClientConfig属性

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

Get-S3Object @params

使用未定义的属性

使用 PowerShell splatting 时，如果您指定的ClientConfig属性不存在，则要等到运行时才会检测到错误，此时它会返回异常。 Amazon Tools for PowerShell 修改上面的示例：

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

Get-S3Object @params

此示例生成类似以下内容的例外：

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

指定 Amazon Web Services 区域

您可以使用ClientConfig参数 Amazon Web Services 区域 为命令设置。区域是通过 RegionEndpoint 属性设置的。根据以下优先级 Amazon Tools for PowerShell 计算要使用的区域：