Set-AzRmStorageContainerImmutabilityPolicy
ストレージ BLOB コンテナーの ImmutabilityPolicy を作成または更新します
構文
AccountName (既定)
Set-AzRmStorageContainerImmutabilityPolicy
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-ContainerName <String>
[-ImmutabilityPeriod <Int32>]
[-AllowProtectedAppendWriteAll <Boolean>]
[-AllowProtectedAppendWrite <Boolean>]
[-Etag <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ExtendAccountName
Set-AzRmStorageContainerImmutabilityPolicy
[-ResourceGroupName] <String>
[-StorageAccountName] <String>
-ContainerName <String>
-ImmutabilityPeriod <Int32>
-Etag <String>
[-ExtendPolicy]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AccountObject
Set-AzRmStorageContainerImmutabilityPolicy
-ContainerName <String>
-StorageAccount <PSStorageAccount>
[-ImmutabilityPeriod <Int32>]
[-AllowProtectedAppendWriteAll <Boolean>]
[-AllowProtectedAppendWrite <Boolean>]
[-Etag <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ExtendAccountObject
Set-AzRmStorageContainerImmutabilityPolicy
-ContainerName <String>
-StorageAccount <PSStorageAccount>
-ImmutabilityPeriod <Int32>
-Etag <String>
[-ExtendPolicy]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ContainerObject
Set-AzRmStorageContainerImmutabilityPolicy
-Container <PSContainer>
[-ImmutabilityPeriod <Int32>]
[-AllowProtectedAppendWriteAll <Boolean>]
[-AllowProtectedAppendWrite <Boolean>]
[-Etag <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ExtendContainerObject
Set-AzRmStorageContainerImmutabilityPolicy
-Container <PSContainer>
-ImmutabilityPeriod <Int32>
-Etag <String>
[-ExtendPolicy]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ImmutabilityPolicyObject
Set-AzRmStorageContainerImmutabilityPolicy
[-InputObject] <PSImmutabilityPolicy>
[-ImmutabilityPeriod <Int32>]
[-AllowProtectedAppendWriteAll <Boolean>]
[-AllowProtectedAppendWrite <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ExtendImmutabilityPolicyObject
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
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AccountName
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AccountObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ContainerObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ImmutabilityPolicyObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AllowProtectedAppendWriteAll
このプロパティは、ロック解除されたポリシーに対してのみ変更できます。
有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを "追加 BLOB とブロック BLOB" の両方に書き込むことができます。 新しいブロックのみを追加でき、既存のブロックは変更または削除できません。
ExtendImmutabilityPolicy API では、このプロパティを変更できません。 '-AllowProtectedAppendWrites' と '-AllowProtectedAppendWritesAll' は相互に排他的です。
パラメーターのプロパティ
| 型: | Boolean
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AccountName
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AccountObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ContainerObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ImmutabilityPolicyObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Container
ストレージ コンテナー オブジェクト
パラメーターのプロパティ
| 型: | PSContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ContainerObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendContainerObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ContainerName
コンテナー名
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 非対応 |
パラメーター セット
AccountName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendAccountName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
AccountObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendAccountObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Etag
不変ポリシーの etag。 -ExtendPolicy が指定されていない場合、Etag は省略可能です。それ以外の場合は Etag が必要です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | IfMatch |
パラメーター セット
AccountName
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AccountObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ContainerObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExtendPolicy
ExtendPolicy を指定して既存の ImmutabilityPolicy を拡張します。 ImmutabilityPolicy がロックされた後は、拡張することしかできません。
パラメーターのプロパティ
パラメーター セット
ExtendAccountName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ExtendAccountObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ExtendContainerObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ExtendImmutabilityPolicyObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ImmutabilityPeriod
作成後の不変期間 (日数)。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ImmutabilityPeriodSinceCreationInDays |
パラメーター セット
AccountName
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
AccountObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ContainerObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ImmutabilityPolicyObject
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
コンテナー名
ImmutabilityPolicyObject
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendImmutabilityPolicyObject
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ResourceGroupName
リソース グループ名。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AccountName
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendAccountName
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-StorageAccount
ストレージ アカウント オブジェクト
パラメーターのプロパティ
パラメーター セット
AccountObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendAccountObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-StorageAccountName
ストレージ アカウント名。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | アカウント名 |
パラメーター セット
AccountName
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExtendAccountName
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。
コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
