Set-AzRmStorageContainerImmutabilityPolicy

模組:: Az.Storage Module

建立或更新儲存體 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>]

Description

Set-AzRmStorageContainerImmutabilityPolicy 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。 Extend 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

此命令會使用 Storage 容器物件更新儲存體 Blob 容器的 ImmutabilityPolicy 3 次：先是 ImmutabilityPeriod 12 天，沒有 etag，然後是 ImmutabilityPeriod 9 天，然後是 Etag，然後啟用 AllowProtectedAppendWrite，最後啟用 AllowProtectedAppendWriteAll。

範例 4：使用 ImmutabilityPolicy 物件擴充儲存體 Blob 容器的 ImmutabilityPolicy

Get-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" | Set-AzRmStorageContainerImmutabilityPolicy -ImmutabilityPeriod 15 -ExtendPolicy

此命令會使用 ImmutabilityPolicy 物件擴充儲存體 Blob 容器的 ImmutabilityPolicy。 Extend ImmutabilityPolicy 只能在鎖定 ImmutabilityPolicy 之後執行。

參數

-AllowProtectedAppendWrite

此屬性只能針對解除鎖定的時間型保留原則進行變更。啟用此屬性後，可以將新區塊寫入附加 Blob，同時維持不變性保護和合規性。只能新增新的區塊，而且任何現有的區塊都無法修改或刪除。 '-AllowProtectedAppendWrites' 和 '-AllowProtectedAppendWritesAll' 是互斥的。

參數屬性

類型:	Boolean
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AccountName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

AccountObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ContainerObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ImmutabilityPolicyObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllowProtectedAppendWriteAll

此屬性只能針對未鎖定的原則變更。啟用後，可以將新區塊寫入「附加和區塊 Blob」，同時保持不變性保護和合規性。只能新增新的區塊，而且任何現有的區塊都無法修改或刪除。使用 ExtendImmutabilityPolicy API 無法變更此屬性。 '-AllowProtectedAppendWrites' 和 '-AllowProtectedAppendWritesAll' 是互斥的。

參數屬性

類型:	Boolean
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AccountName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

AccountObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ContainerObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ImmutabilityPolicyObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	參見

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Container

儲存容器物件

參數屬性

類型:	PSContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ContainerObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendContainerObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ContainerName

容器名稱

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	N

參數集

AccountName

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendAccountName

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

AccountObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendAccountObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:	IAzureContextContainer
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	AzContext, AzureRmContext, AzureCredential

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Etag

不變性原則 etag。如果未指定 -ExtendPolicy，則 Etag 是選用的;否則需要 Etag。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	如果匹配

參數集

AccountName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

AccountObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ContainerObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExtendPolicy

指出 ExtendPolicy 以擴充現有的 ImmutabilityPolicy。 ImmutabilityPolicy 鎖定後，只能擴充。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ExtendAccountName

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ExtendAccountObject

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ExtendContainerObject

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ExtendImmutabilityPolicyObject

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ImmutabilityPeriod

自創建以來的不變期（以天為單位）。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	不變性週期自創建在日

參數集

AccountName

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

AccountObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ContainerObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

ImmutabilityPolicyObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

容器名稱

參數屬性

類型:	PSImmutabilityPolicy
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	不變性原則

參數集

ImmutabilityPolicyObject

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendImmutabilityPolicyObject

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ResourceGroupName

資源組名。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AccountName

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendAccountName

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-StorageAccount

儲存體帳戶物件

參數屬性

類型:	PSStorageAccount
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AccountObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendAccountObject

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-StorageAccountName

儲存體帳戶名稱。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	帳戶名稱

參數集

AccountName

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

ExtendAccountName

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	威斯康辛

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸出

PSImmutabilityPolicy

意見反應

此頁面對您有幫助嗎？

共用方式為

Set-AzRmStorageContainerImmutabilityPolicy

語法

AccountName (預設值)

ExtendAccountName

AccountObject

ExtendAccountObject

ContainerObject

ExtendContainerObject

ImmutabilityPolicyObject

ExtendImmutabilityPolicyObject

Description

範例

範例 1：使用儲存體帳戶名稱和容器名稱建立或更新儲存體 Blob 容器的 ImmutabilityPolicy

範例 2：使用儲存體帳戶物件擴充儲存體 Blob 容器的 ImmutabilityPolicy

範例 3：更新儲存體 Blob 容器的 ImmutabilityPolicy

範例 4：使用 ImmutabilityPolicy 物件擴充儲存體 Blob 容器的 ImmutabilityPolicy

參數

-AllowProtectedAppendWrite

參數屬性

參數集

-AllowProtectedAppendWriteAll

參數屬性

參數集

-Confirm

參數屬性

參數集

-Container

參數屬性

參數集

-ContainerName

參數屬性

參數集

-DefaultProfile

參數屬性

參數集

-Etag

參數屬性

參數集

-ExtendPolicy

參數屬性

參數集

-ImmutabilityPeriod

參數屬性

參數集

-InputObject

參數屬性

參數集

-ResourceGroupName

參數屬性

參數集

-StorageAccount

參數屬性

參數集

-StorageAccountName

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

輸出

PSImmutabilityPolicy

意見反應