Set-AzureStorageCORSRule
ストレージ サービスの種類の CORS 規則を設定します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Set-AzureStorageCORSRule
[-ServiceType] <StorageServiceType>
-CorsRules <PSCorsRule[]>
[-PassThru]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
説明
Set-AzureStorageCORSRule コマンドレットは、Azure Storage サービスの種類に対してクロスオリジン リソース共有 (CORS) 規則を設定します。 このコマンドレットのストレージ サービスの種類は、BLOB、Table、Queue、File です。 このコマンドレットは、既存の規則を上書きします。 現在の規則を確認するには、Get-AzureStorageCORSRule コマンドレットを使用します。
例
例 1: BLOB サービスに CORS 規則を割り当てる
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変数に割り当てます。 このコマンドでは、標準を使用して、このコード ブロック内の複数の行に拡張します。 2 番目のコマンドは、$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 コマンドレットを使用して、BLOB の種類の現在の CORS 規則を取得します。 このコマンドは、$CorsRules配列変数に規則を格納します。 2 番目と 3 番目のコマンドは、$CorsRulesの最初の規則を変更します。 最後のコマンドは、$CorsRulesのルールを BLOB サービスの種類に割り当てます。 変更後の規則によって、現在の CORS 規則が上書きされます。
パラメーター
-ClientTimeoutPerRequest
1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。
型: | Nullable<T>[Int32] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ConcurrentTaskCount
同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。
型: | Nullable<T>[Int32] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Context
Azure Storage コンテキストを指定します。 コンテキストを取得するには、New-AzureStorageContext コマンドレットを使用します。
型: | IStorageContext |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-CorsRules
CORS 規則の配列を指定します。 Get-AzureStorageCORSRule コマンドレットを使用して、既存の規則を取得できます。
型: | PSCorsRule[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PassThru
このコマンドレットは、操作の成功を反映するブール値を返します。 既定では、このコマンドレットは値を返しません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServerTimeoutPerRequest
要求のサーバー部分のタイムアウト期間の長さを指定します。
型: | Nullable<T>[Int32] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServiceType
このコマンドレットが規則を割り当てる Azure Storage サービスの種類を指定します。 このパラメーターの有効値は、次のとおりです。
- BLOB
- テーブル
- キュー
- ファイル
型: | StorageServiceType |
指定可能な値: | Blob, Table, Queue, File |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |