共用方式為


Set-AzureStorageCORSRule

設定記憶體服務類型的 CORS 規則。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

語法

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

Description

Set-AzureStorageCORSRule Cmdlet 會為 Azure 儲存體 服務類型設定跨原始來源資源分享 (CORS) 規則。 此 Cmdlet 的記憶體服務類型為 Blob、數據表、佇列和檔案。 此 Cmdlet 會覆寫現有的規則。 若要查看目前的規則,請使用 Get-AzureStorageCORSRule Cmdlet。

範例

範例 1:將 CORS 規則指派給 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

第一個命令會將規則陣列指派給$CorsRules變數。 此命令會使用標準延伸至此程式代碼區塊中的數行。 第二個命令會將$CorsRules中的規則指派給 Blob 服務類型。

範例 2:變更 Blob 服務的 CORS 規則屬性

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

第一個命令會使用 Get-AzureStorageCORSRule Cmdlet 取得 Blob 類型的目前 CORS 規則。 命令會將規則儲存在$CorsRules陣列變數中。 第二和第三個命令會修改$CorsRules中的第一個規則。 最後一個命令會將$CorsRules中的規則指派給 Blob 服務類型。 修訂的規則會覆寫目前的 CORS 規則。

參數

-ClientTimeoutPerRequest

指定一個服務要求的用戶端超時時間間隔,以秒為單位。 如果先前的呼叫在指定的間隔內失敗,此 Cmdlet 會重試要求。 如果此 Cmdlet 在間隔經過之前未收到成功的回應,此 Cmdlet 會傳回錯誤。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConcurrentTaskCount

指定並行網路呼叫上限。 您可以藉由指定並行網路呼叫數目上限,使用此參數來限制並行 CPU 和頻寬使用量的並行存取。 指定的值是絕對計數,不會乘以核心計數。 此參數可協助減少低頻寬環境中的網路連線問題,例如每秒 100 千位。 預設值為 10。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Context

指定 Azure 儲存體 內容。 若要取得內容,請使用 New-AzureStorageContext Cmdlet。

類型:IStorageContext
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-CorsRules

指定 CORS 規則的陣列。 您可以使用 Get-AzureStorageCORSRule Cmdlet 來擷取現有的規則。

類型:PSCorsRule[]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

指出此 Cmdlet 會傳回 Boolean,反映作業的成功。 根據預設,此 Cmdlet 不會傳回值。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ServerTimeoutPerRequest

指定要求的伺服器部分逾時期間長度。

類型:Nullable<T>[Int32]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ServiceType

指定此 Cmdlet 指派規則的 Azure 儲存體 服務類型。 此參數可接受的值為:

  • Blob
  • Table
  • 待辦事項
  • 檔案
類型:StorageServiceType
接受的值:Blob, Table, Queue, File
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸入

IStorageContext

輸出

PSCorsRule