你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Set-AzRmStorageContainerImmutabilityPolicy
创建或更新 存储 blob 容器的不可变性Policy
语法
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-AzRm存储ContainerImmutabilityPolicy cmdlet 创建或更新 存储 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
此命令使用 存储 容器对象 3 次更新 存储 blob 容器的 ImmutabilityPolicy:首先以 ImmutabilityPeriod 12 天没有 etag,然后使用 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”互斥。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowProtectedAppendWriteAll
只能更改已解锁策略的属性。 启用后,新块可以同时写入“Appened 和块 Blob”,同时保持不可变性保护和符合性。 只能添加新块,任何现有块都无法修改或删除。 不能使用 ExtendImmutabilityPolicy API 更改此属性。 “-AllowProtectedAppendWrites”和“-AllowProtectedAppendWritesAll”互斥。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Container
存储容器对象
Type: | PSContainer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerName
容器名
Type: | String |
Aliases: | N |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
-Etag
不可变性策略 etag。 如果未指定 -ExtendPolicy,则 Etag 是可选的;否则需要 Etag。
Type: | String |
Aliases: | IfMatch |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendPolicy
指示 ExtendPolicy 以扩展现有 ImmutabilityPolicy。 锁定 ImmutabilityPolicy 后,它只能进行扩展。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutabilityPeriod
自创建以来的不可变性时期(以天为单位)。
Type: | Int32 |
Aliases: | ImmutabilityPeriodSinceCreationInDays |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
容器名
Type: | PSImmutabilityPolicy |
Aliases: | ImmutabilityPolicy |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
资源组名称。
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 |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
输出
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈