Set-AzureStorageCORSRule

  • Riferimento
Modulo:
Azure.Storage

Imposta le regole CORS per un tipo di servizio di archiviazione.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureStorageCORSRule
   [-ServiceType] <StorageServiceType>
   -CorsRules <PSCorsRule[]>
   [-PassThru]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureStorageCORSRule imposta le regole CORS (Cross-Origin Resource Sharing) per un tipo di servizio Archiviazione di Azure. I tipi di servizi di archiviazione per questo cmdlet sono BLOB, Table, Queue e File. Questo cmdlet sovrascrive le regole esistenti. Per visualizzare le regole correnti, usare il cmdlet Get-AzureStorageCORSRule.

Esempio

Esempio 1: Assegnare regole CORS al servizio BLOB

PS C:\>$CorsRules = (@{
    AllowedHeaders=@("x-ms-blob-content-type","x-ms-blob-content-disposition");
    AllowedOrigins=@("*");
    MaxAgeInSeconds=30;
    AllowedMethods=@("Get","Connect")},
    @{
    AllowedOrigins=@("http://www.fabrikam.com","http://www.contoso.com"); 
    ExposedHeaders=@("x-ms-meta-data*","x-ms-meta-customheader"); 
    AllowedHeaders=@("x-ms-meta-target*","x-ms-meta-customheader");
    MaxAgeInSeconds=30;
    AllowedMethods=@("Put")})
PS C:\> Set-AzureStorageCORSRule -ServiceType Blob -CorsRules $CorsRules

Il primo comando assegna una matrice di regole alla variabile $CorsRules. Questo comando usa standard che si estende su più righe in questo blocco di codice. Il secondo comando assegna le regole in $CorsRules al tipo di servizio BLOB.

Esempio 2: Modificare le proprietà di una regola CORS per il servizio BLOB

PS C:\>$CorsRules = Get-AzureStorageCORSRule -ServiceType Blob
PS C:\> $CorsRules[0].AllowedHeaders = @("x-ms-blob-content-type", "x-ms-blob-content-disposition")
PS C:\> $CorsRules[0].AllowedMethods = @("Get", "Connect", "Merge")
PS C:\> Set-AzureStorageCORSRule -ServiceType Blob -CorsRules $CorsRules

Il primo comando ottiene le regole CORS correnti per il tipo di BLOB usando il cmdlet Get-AzureStorageCORSRule . Il comando archivia le regole nella variabile di matrice $CorsRules. Il secondo e il terzo comando modificano la prima regola in $CorsRules. Il comando finale assegna le regole in $CorsRules al tipo di servizio BLOB. Le regole modificate sovrascrivono le regole CORS correnti.

Parametri

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo nell'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Context

Specifica un contesto di Archiviazione di Azure. Per ottenere un contesto, usare il cmdlet New-AzureStorageContext.

Tipo:IStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CorsRules

Specifica una matrice di regole CORS. È possibile recuperare le regole esistenti usando il cmdlet Get-AzureStorageCORSRule.

Tipo:PSCorsRule[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che questo cmdlet restituisce un valore booleano che riflette l'esito positivo dell'operazione. Per impostazione predefinita, questo cmdlet non restituisce un valore.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServerTimeoutPerRequest

Specifica la durata del periodo di timeout per la parte server di una richiesta.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServiceType

Specifica il tipo di servizio Archiviazione di Azure per il quale questo cmdlet assegna regole. I valori validi per questo parametro sono:

  • BLOB
  • Tabella
  • Queue
  • file
Tipo:StorageServiceType
Valori accettati:Blob, Table, Queue, File
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

IStorageContext

Output

PSCorsRule