次の方法で共有

Set-AzRmStorageContainerImmutabilityPolicy

  • リファレンス
モジュール:
Az.Storage

ストレージ BLOB コンテナーの ImmutabilityPolicy を作成または更新します

構文

Set-AzRmStorageContainerImmutabilityPolicy
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -ContainerName <String>
   [-ImmutabilityPeriod <Int32>]
   [-AllowProtectedAppendWriteAll <Boolean>]
   [-AllowProtectedAppendWrite <Boolean>]
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -ContainerName <String>
   -ImmutabilityPeriod <Int32>
   -Etag <String>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   -ContainerName <String>
   -StorageAccount <PSStorageAccount>
   [-ImmutabilityPeriod <Int32>]
   [-AllowProtectedAppendWriteAll <Boolean>]
   [-AllowProtectedAppendWrite <Boolean>]
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   -ContainerName <String>
   -StorageAccount <PSStorageAccount>
   -ImmutabilityPeriod <Int32>
   -Etag <String>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   -Container <PSContainer>
   [-ImmutabilityPeriod <Int32>]
   [-AllowProtectedAppendWriteAll <Boolean>]
   [-AllowProtectedAppendWrite <Boolean>]
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   -Container <PSContainer>
   -ImmutabilityPeriod <Int32>
   -Etag <String>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   [-InputObject] <PSImmutabilityPolicy>
   [-ImmutabilityPeriod <Int32>]
   [-AllowProtectedAppendWriteAll <Boolean>]
   [-AllowProtectedAppendWrite <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRmStorageContainerImmutabilityPolicy
   [-InputObject] <PSImmutabilityPolicy>
   -ImmutabilityPeriod <Int32>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzRmStorageContainerImmutabilityPolicy コマンドレットは、ストレージ BLOB コンテナーの ImmutabilityPolicy を作成または更新します

例

例 1: ストレージ アカウント名とコンテナー名を使用してストレージ BLOB コンテナーの ImmutabilityPolicy を作成または更新する

Set-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -ImmutabilityPeriod 10

このコマンドは、ストレージ アカウント名とコンテナー名を使用して、ストレージ BLOB コンテナーの ImmutabilityPolicy を作成または更新します。

例 2: ストレージ アカウント オブジェクトを使用してストレージ BLOB コンテナーの ImmutabilityPolicy を拡張する

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
$policy = Get-AzRmStorageContainerImmutabilityPolicy -StorageAccount $accountObject -ContainerName "myContainer"
Set-AzRmStorageContainerImmutabilityPolicy -StorageAccount $accountObject -ContainerName "myContainer" -ImmutabilityPeriod 20 -Etag $policy.Etag -ExtendPolicy

このコマンドは、ストレージ アカウント オブジェクトを使用して、ストレージ BLOB コンテナーの ImmutabilityPolicy を拡張します。 拡張 ImmutabilityPolicy は、ImmutabilityPolicy がロックされた後にのみ実行できます。

例 3: ストレージ BLOB コンテナーの ImmutabilityPolicy を更新する

$containerObject = Get-AzRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -Name "myContainer"
$policy = Set-AzRmStorageContainerImmutabilityPolicy -Container $containerObject -ImmutabilityPeriod 12
$policy = Set-AzRmStorageContainerImmutabilityPolicy -Container $containerObject -ImmutabilityPeriod 9 -Etag $policy.Etag
$policy = Set-AzRmStorageContainerImmutabilityPolicy -Container $containerObject -AllowProtectedAppendWrite $true
$policy = Set-AzRmStorageContainerImmutabilityPolicy -Container $containerObject -AllowProtectedAppendWrite $false -AllowProtectedAppendWriteAll $true

このコマンドは、ストレージ コンテナー オブジェクトを持つストレージ BLOB コンテナーの ImmutabilityPolicy を 3 回更新します。最初に etag なしで ImmutabilityPeriod 12 日間、etag で ImmutabilityPeriod 9 日間に更新した後、AllowProtectedAppendWrite を有効にし、最後に AllowProtectedAppendWriteAll を有効にします。

例 4: ImmutabilityPolicy オブジェクトを使用してストレージ BLOB コンテナーの ImmutabilityPolicy を拡張する

Get-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" | Set-AzRmStorageContainerImmutabilityPolicy -ImmutabilityPeriod 15 -ExtendPolicy

このコマンドは、ImmutabilityPolicy オブジェクトを使用して、ストレージ BLOB コンテナーの ImmutabilityPolicy を拡張します。 拡張 ImmutabilityPolicy は、ImmutabilityPolicy がロックされた後にのみ実行できます。

パラメーター

-AllowProtectedAppendWrite

このプロパティは、ロック解除された時間ベースのアイテム保持ポリシーに対してのみ変更できます。 このプロパティを有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを追加 BLOB に書き込むことができます。 新しいブロックのみを追加でき、既存のブロックは変更または削除できません。 '-AllowProtectedAppendWrites' と '-AllowProtectedAppendWritesAll' は相互に排他的です。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AllowProtectedAppendWriteAll

このプロパティは、ロック解除されたポリシーに対してのみ変更できます。 有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを "Appened BLOB とブロック BLOB" の両方に書き込むことができます。 新しいブロックのみを追加でき、既存のブロックは変更または削除できません。 ExtendImmutabilityPolicy API では、このプロパティを変更できません。 '-AllowProtectedAppendWrites' と '-AllowProtectedAppendWritesAll' は相互に排他的です。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Container

ストレージ コンテナー オブジェクト

型:PSContainer
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ContainerName

コンテナー名

型:String
Aliases:N
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Etag

不変ポリシーの etag。 -ExtendPolicy が指定されていない場合、Etag は省略可能です。それ以外の場合は Etag が必要です。

型:String
Aliases:IfMatch
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExtendPolicy

ExtendPolicy を指定して既存の ImmutabilityPolicy を拡張します。 ImmutabilityPolicy がロックされた後は、拡張することしかできません。

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ImmutabilityPeriod

作成後の不変期間 (日数)。

型:Int32
Aliases:ImmutabilityPeriodSinceCreationInDays
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

コンテナー名

型:PSImmutabilityPolicy
Aliases:ImmutabilityPolicy
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

リソース グループ名。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageAccount

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

型:PSStorageAccount
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageAccountName

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

型:String
Aliases:AccountName
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

出力

PSImmutabilityPolicy