Update-AzStorageBlobServiceProperty

Azure Storage Blob Service のサービス プロパティを変更します。

構文

Update-AzStorageBlobServiceProperty
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      [-DefaultServiceVersion <String>]
      [-EnableChangeFeed <Boolean>]
      [-ChangeFeedRetentionInDays <Int32>]
      [-IsVersioningEnabled <Boolean>]
      [-CorsRule <PSCorsRule[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzStorageBlobServiceProperty
      -StorageAccount <PSStorageAccount>
      [-DefaultServiceVersion <String>]
      [-EnableChangeFeed <Boolean>]
      [-ChangeFeedRetentionInDays <Int32>]
      [-IsVersioningEnabled <Boolean>]
      [-CorsRule <PSCorsRule[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzStorageBlobServiceProperty
      [-ResourceId] <String>
      [-DefaultServiceVersion <String>]
      [-EnableChangeFeed <Boolean>]
      [-ChangeFeedRetentionInDays <Int32>]
      [-IsVersioningEnabled <Boolean>]
      [-CorsRule <PSCorsRule[]>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Update-AzStorageBlobServiceProperty コマンドレットは、Azure Storage BLOB サービスのサービス プロパティを変更します。

例 1: Blob service DefaultServiceVersion を 2018-03-28 に設定する

Update-AzStorageBlobServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -DefaultServiceVersion 2018-03-28

StorageAccountName            : mystorageaccount
ResourceGroupName             : myresourcegroup
DefaultServiceVersion         : 2018-03-28
DeleteRetentionPolicy.Enabled : False
DeleteRetentionPolicy.Days    : 
RestorePolicy.Enabled         : 
RestorePolicy.Days            : 
ChangeFeed.Enabled            : 
ChangeFeed.RetentionInDays    :
IsVersioningEnabled           :

このコマンドは、Blob Service の DefaultServiceVersion を 2018-03-28 に設定します。

例 2: ChangeFeedRetentionInDays を 5 日間とするストレージ アカウントの BLOB サービスで Changefeed を有効にする

Update-AzStorageBlobServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -EnableChangeFeed $true -ChangeFeedRetentionInDays 5

StorageAccountName            : mystorageaccount
ResourceGroupName             : myresourcegroup
DefaultServiceVersion         : 
DeleteRetentionPolicy.Enabled : False
DeleteRetentionPolicy.Days    : 
RestorePolicy.Enabled         : 
RestorePolicy.Days            : 
ChangeFeed.Enabled            : True
ChangeFeed.RetentionInDays    : 5
IsVersioningEnabled           :

このコマンドにより、ChangeFeedRetentionInDays を 5 日として使用するストレージ アカウントの BLOB サービスで Changefeed が有効になります。 Azure Blob Storage での変更フィードのサポートは、BLOB レベルの作成、変更、または削除のイベントについて、GPv2 または BLOB ストレージ アカウントをリッスンすることによって機能します。 次に、ストレージ アカウント内の $blobchangefeed コンテナーに格納されている BLOB のイベントの順序付きログを出力します。 シリアル化された変更は Apache Avro ファイルとして永続化され、非同期的および増分的に処理できます。 ChangeFeedRetentionInDays を指定しない場合、サービス プロパティで null 値が取得され、変更フィードの保持期間が無限であることを示します。

例 3: ストレージ アカウントの BLOB サービスでバージョン管理を有効にする

Update-AzStorageBlobServiceProperty -ResourceGroupName "myresourcegroup" -AccountName "mystorageaccount" -IsVersioningEnabled $true

StorageAccountName            : mystorageaccount
ResourceGroupName             : myresourcegroup
DefaultServiceVersion         : 
DeleteRetentionPolicy.Enabled : False
DeleteRetentionPolicy.Days    : 
RestorePolicy.Enabled         : 
RestorePolicy.Days            : 
ChangeFeed                    : 
ChangeFeed.RetentionInDays    :
IsVersioningEnabled           : True

このコマンドを実行すると、ストレージ アカウントの BLOB サービスでバージョン管理が有効になります。

例 4: CORS 規則を更新する

$CorsRules = (@{
    AllowedHeaders=@("x-ms-blob-content-type","x-ms-blob-content-disposition");
    ExposedHeaders=@(); 
    AllowedOrigins=@("*");
    AllowedMethods=@("TRACE","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")})

$property = Update-AzStorageBlobServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule $CorsRules
$property.Cors.CorsRulesProperty

AllowedOrigins  : {*}
AllowedMethods  : {TRACE, CONNECT}
MaxAgeInSeconds : 0
ExposedHeaders  : {}
AllowedHeaders  : {x-ms-blob-content-type, x-ms-blob-content-disposition}

AllowedOrigins  : {http://www.fabrikam.com, http://www.contoso.com}
AllowedMethods  : {PUT}
MaxAgeInSeconds : 30
ExposedHeaders  : {x-ms-meta-customheader, x-ms-meta-data*}
AllowedHeaders  : {x-ms-meta-customheader, x-ms-meta-target*}

最初のコマンドは、ルールの配列を$CorsRules変数に割り当てます。 このコマンドでは、標準を使用して、このコード ブロック内の複数の行に拡張します。 2 番目のコマンドでは、$CorsRulesの規則をストレージ アカウントの BLOB サービスに設定します。

例 5: CORS 規則をクリーンアップする

Update-AzStorageBlobServiceProperty -ResourceGroupName myresourcegroup -StorageAccountName mystorageaccount -CorsRule @()

このコマンドは、パラメーター CorsRule に @() を入力することで、ストレージ アカウントの CORS 規則をクリーンします。

パラメーター

-ChangeFeedRetentionInDays

changeFeed リテンション期間を日数で示します。 最小値は 1 日で、最大値は 14,6000 日 (400 年) です。 changeFeed がサービス プロパティで null 値を取得し、変更フィードの無限の保持を示す場合は指定しないでください。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CorsRule

BLOB サービスの CORS 規則を指定します。

Type:PSCorsRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultServiceVersion

設定する既定のサービス バージョン

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableChangeFeed

$trueに設定してストレージ アカウントの変更フィードログを有効にし、$falseに設定して変更フィードのログ記録を無効にします。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsVersioningEnabled

true に設定されている場合、バージョン管理が有効になっているかどうかを取得または設定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソース グループ名。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceId

ストレージ アカウントのリソース ID、または BLOB サービスのプロパティのリソース ID を入力します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccount

ストレージ アカウント オブジェクト

Type:PSStorageAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

ストレージ アカウント名。

Type:String
Aliases:AccountName, Name
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSStorageAccount

String

出力

PSBlobServiceProperties