Set-AzRmStorageContainerImmutabilityPolicy
建立或更新記憶體 Blob 容器的不變性原則
語法
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>] Description
Set-AzRmStorageContainerImmutabilityPolicy Cmdlet 會建立或更新記憶體 Blob 容器的 ImmutabilityPolicy
範例
範例 1：使用記憶體帳戶名稱和容器名稱建立或更新記憶體 Blob 容器的不變性原則
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 容器的不變性原則
$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 次：第一次更新 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' 互斥。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllowProtectedAppendWriteAll
此屬性只能針對已解除鎖定的原則進行變更。 啟用時，新的區塊可以同時寫入「Appened」和「區塊 Blob」，同時維護不變性保護與合規性。 只能新增新的區塊，而且任何現有的區塊都無法修改或刪除。 使用 ExtendImmutabilityPolicy API 無法變更此屬性。 '-AllowProtectedAppendWrites' 和 '-AllowProtectedAppendWritesAll' 互斥。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Container
記憶體容器物件
| 類型: | PSContainer |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ContainerName
容器名稱
| 類型: | String |
| 別名: | N |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Etag
不變性原則 etag。 如果未指定 -ExtendPolicy，Etag 是選擇性的;否則需要 Etag。
| 類型: | String |
| 別名: | IfMatch |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ExtendPolicy
指出 ExtendPolicy 以擴充現有的 ImmutabilityPolicy。 鎖定 ImmutabilityPolicy 之後，只能進行擴充。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ImmutabilityPeriod
建立后的不變性期間，以天為單位。
| 類型: | Int32 |
| 別名: | ImmutabilityPeriodSinceCreationInDays |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
容器名稱
| 類型: | PSImmutabilityPolicy |
| 別名: | ImmutabilityPolicy |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceGroupName
資源組名。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccount
記憶體帳戶物件
| 類型: | PSStorageAccount |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountName
儲存體帳戶名稱。
| 類型: | String |
| 別名: | AccountName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
