Bagikan melalui

Set-AzureStorageCORSRule

  • Referensi
Modul:
Azure.Storage

Mengatur aturan CORS untuk jenis layanan Storage.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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

Deskripsi

Cmdlet Set-AzureStorageCORSRule mengatur aturan Cross-Origin Resource Sharing (CORS) untuk jenis layanan Azure Storage. Jenis layanan penyimpanan untuk cmdlet ini adalah Blob, Table, Queue, dan File. Cmdlet ini menimpa aturan yang ada. Untuk melihat aturan saat ini, gunakan cmdlet Get-AzureStorageCORSRule.

Contoh

Contoh 1: Menetapkan aturan CORS ke layanan 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

Perintah pertama menetapkan array aturan ke variabel $CorsRules. Perintah ini menggunakan perluasan standar selama beberapa baris dalam blok kode ini. Perintah kedua menetapkan aturan dalam $CorsRules ke jenis layanan Blob.

Contoh 2: Mengubah properti aturan CORS untuk layanan 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

Perintah pertama mendapatkan aturan CORS saat ini untuk jenis Blob dengan menggunakan cmdlet Get-AzureStorageCORSRule . Perintah menyimpan aturan dalam variabel array $CorsRules. Perintah kedua dan ketiga memodifikasi aturan pertama dalam $CorsRules. Perintah akhir menetapkan aturan dalam $CorsRules ke jenis layanan Blob. Aturan yang direvisi menimpa aturan CORS saat ini.

Parameter

-ClientTimeoutPerRequest

Menentukan interval waktu habis sisi klien, dalam hitungan detik, untuk satu permintaan layanan. Jika panggilan sebelumnya gagal dalam interval yang ditentukan, cmdlet ini akan mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ConcurrentTaskCount

Menentukan panggilan jaringan bersamaan maksimum. Anda dapat menggunakan parameter ini untuk membatasi konkurensi untuk membatasi penggunaan CPU dan bandwidth lokal dengan menentukan jumlah maksimum panggilan jaringan bersamaan. Nilai yang ditentukan adalah jumlah absolut dan tidak dikalikan dengan jumlah inti. Parameter ini dapat membantu mengurangi masalah koneksi jaringan di lingkungan bandwidth rendah, seperti 100 kilobit per detik. Nilai defaultnya adalah 10.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Context

Menentukan konteks Azure Storage. Untuk mendapatkan konteks, gunakan cmdlet New-AzureStorageContext.

Jenis:IStorageContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-CorsRules

Menentukan array aturan CORS. Anda dapat mengambil aturan yang ada menggunakan cmdlet Get-AzureStorageCORSRule.

Jenis:PSCorsRule[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PassThru

Menunjukkan bahwa cmdlet ini mengembalikan Boolean yang mencerminkan keberhasilan operasi. Secara default, cmdlet ini tidak mengembalikan nilai.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServerTimeoutPerRequest

Menentukan lamanya periode waktu habis untuk bagian server dari permintaan.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServiceType

Menentukan jenis layanan Azure Storage yang cmdlet ini menetapkan aturan. Nilai yang dapat diterima untuk parameter ini adalah:

  • Blob
  • Tabel
  • Antrean
  • File
Jenis:StorageServiceType
Nilai yang diterima:Blob, Table, Queue, File
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

Input

IStorageContext

Output

PSCorsRule