你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureRmStorageContainerImmutabilityPolicy
创建或更新 存储 blob 容器的不可变性Policy
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 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-AzureRm存储ContainerImmutabilityPolicy cmdlet 创建或更新 存储 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 容器的 ImmutabilityPolicy
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
提示你在运行 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: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| Type: | IAzureContextContainer |
| Aliases: | 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: | Named |
| 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 |
输入
Microsoft.Azure.Commands.Management。存储。Models.PSImmutabilityPolicy