Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Uso del parametro ClientConfig nei cmdlet

Il parametro ClientConfig può essere usato per specificare determinate impostazioni di configurazione durante la connessione a un servizio. La maggior parte delle possibili proprietà di questo parametro è definita nella classe Amazon.Runtime.ClientConfig, ereditata nelle API per i servizi AWS. Per un esempio di ereditarietà semplice, fai riferimento alla classe Amazon.Keyspaces.AmazonKeyspacesConfig. Inoltre, alcuni servizi definiscono proprietà aggiuntive che sono appropriate solo per il servizio specifico. Per un esempio di definizione di proprietà aggiuntive, fai riferimento alla classe Amazon.S3.AmazonS3Config e in particolare alla proprietà ForcePathStyle.

Uso del parametro ClientConfig

Per usare il parametro ClientConfig, puoi specificarlo nel riga di comando come oggetto ClientConfig oppure puoi usare gli elenchi unitari di parametri di PowerShell per passare come unità una raccolta di valori di parametri a un comando. Questi metodi vengono mostrati negli esempi seguenti. Gli esempi presuppongono che sia stato installato e importato il modulo AWS.Tools.S3 e che tu abbia un profilo di credenziali [default] con le autorizzazioni appropriate.

Definizione di un oggetto ClientConfig

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

Aggiunta di proprietà ClientConfig usando gli elenchi unitari di parametri di PowerShell

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

Get-S3Object @params

Uso di una proprietà non definita

Se quando usi gli elenchi unitari di parametri di PowerShell specifichi una proprietà ClientConfig che non esiste, AWS Tools for PowerShell non rileva l'errore fino al runtime, momento in cui restituisce un'eccezione. Modificando l'esempio precedente:

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

Get-S3Object @params

Questo esempio genera un'eccezione simile alla seguente:

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

Impostazione della Regione AWS

Puoi usare il parametro ClientConfig per impostare la Regione AWS per il comando. La regione viene impostata tramite la proprietà RegionEndpoint. AWS Tools for PowerShell calcola la regione da usare in base alle priorità seguenti: