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 |