次の方法で共有


Set-AzureRmStorageContainerImmutabilityPolicy

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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

説明

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

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

PS C:\>Set-AzureRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -ImmutabilityPeriod 10

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

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

PS C:\>$accountObject = Get-AzureRmStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
PS C:\>$policy = Get-AzureRmStorageContainerImmutabilityPolicy -StorageAccount $accountObject -ContainerName "myContainer"
PS C:\>Set-AzureRmStorageContainerImmutabilityPolicy -StorageAccount $accountObject -ContainerName "myContainer" -ImmutabilityPeriod 20 -Etag $policy.Etag -ExtendPolicy

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

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

PS C:\>$containerObject = Get-AzureRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -Name "myContainer"
PS C:\>$policy = Set-AzureRmStorageContainerImmutabilityPolicy -Container $containerObject -ImmutabilityPeriod 12
PS C:\>$policy = Set-AzureRmStorageContainerImmutabilityPolicy -Container $containerObject -ImmutabilityPeriod 9 -Etag $policy.Etag

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

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

PS C:\>Get-AzureRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" | Set-AzureRmStorageContainerImmutabilityPolicy -ImmutabilityPeriod 15 -ExtendPolicy

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

パラメーター

-Confirm

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

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

-Container

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

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

-ContainerName

コンテナー名

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

-DefaultProfile

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

型:IAzureContextContainer
Aliases: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
配置:Named
規定値: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

Microsoft.Azure.Commands.Management.Storage.Models.PSImmutabilityPolicy

出力

PSImmutabilityPolicy