Set-AzRmStorageContainerImmutabilityPolicy

Referenz

Modul:: Az.Storage

Erstellt oder aktualisiert Die Unveränderlichkeitsrichtlinie eines Speicher-BLOB-Containers

Syntax

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>]

Beschreibung

Das Cmdlet Set-AzRmStorageContainerImmutabilityPolicy erstellt oder aktualisiert die Unveränderlichkeitsrichtlinie eines Speicher-Blob-Containers.

Beispiele

Beispiel 1: Erstellen oder Aktualisieren der Unveränderlichkeitsrichtlinie eines Speicher-BLOB-Containers mit dem Namen und dem Containernamen des Speicherkontos

Set-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -ImmutabilityPeriod 10

Dieser Befehl erstellt oder aktualisiert die Unveränderlichkeitsrichtlinie eines Speicher-BLOB-Containers mit dem Namen und dem Containernamen des Speicherkontos.

Beispiel 2: Erweitern der Unveränderlichkeitsrichtlinie eines Speicher-BLOB-Containers mit Speicherkontoobjekt

$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

Mit diesem Befehl wird die Unveränderbarkeitspolicy eines Speicher-BLOB-Containers um das Speicherkontoobjekt erweitert. Extend ImmutabilityPolicy kann nur ausgeführt werden, nachdem ImmutabilityPolicy gesperrt wurde.

Beispiel 3: Aktualisieren der Unveränderlichkeitsrichtlinie eines Speicher-BLOB-Containers

$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

Dieser Befehl aktualisiert Die Unveränderlichkeitsrichtlinie eines Speicher-Blobcontainers mit Speichercontainerobjekt 3 Mal: Zuerst 12 Tage ohne etag für ImmutabilityPeriod, dann 9 Tage mit dem etag, dann allowProtectedAppendWrite aktiviert, schließlich AllowProtectedAppendWrite aktiviert, schließlich AllowProtectedAppendWriteAll.

Beispiel 4: Erweitern der Unveränderlichkeitsrichtlinie eines Speicher-BLOB-Containers mit DemmutabilityPolicy-Objekt

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

Mit diesem Befehl wird die UnveränderbarkeitPolicy eines Speicher-BLOB-Containers mit dem ImmutabilityPolicy-Objekt erweitert. Extend ImmutabilityPolicy kann nur ausgeführt werden, nachdem ImmutabilityPolicy gesperrt wurde.

Parameter

-AllowProtectedAppendWrite

Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn diese Eigenschaft aktiviert ist, können neue Blöcke in ein Anfüge-Blob geschrieben werden und gleichzeitig unveränderlichen Schutz und Compliance beibehalten. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden. "-AllowProtectedAppendWrites" und "-AllowProtectedAppendWritesAll" schließen sich gegenseitig aus.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AllowProtectedAppendWriteAll

Diese Eigenschaft kann nur für entsperrte Richtlinien geändert werden. Wenn diese Option aktiviert ist, können neue Blöcke sowohl in "Appened" als auch in "Block Blobs" geschrieben werden und gleichzeitig unveränderlichen Schutz und Compliance beibehalten werden. Es können nur neue Blöcke hinzugefügt werden. Vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden. "-AllowProtectedAppendWrites" und "-AllowProtectedAppendWritesAll" schließen sich gegenseitig aus.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Container

Speichercontainerobjekt

Typ:	PSContainer
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ContainerName

Containername

Typ:	String
Aliase:	N
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Etag

Unveränderlichkeitsrichtlinie etag. Wenn -ExtendPolicy nicht angegeben ist, ist Etag optional; andernfalls ist Etag erforderlich.

Typ:	String
Aliase:	IfMatch
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ExtendPolicy

Geben Sie "ExtendPolicy" an, um eine vorhandene Unveränderlichkeitsrichtlinie zu erweitern. Nachdem Die Unveränderlichkeitsrichtlinie gesperrt wurde, kann sie nur erweitert werden.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ImmutabilityPeriod

Unveränderlichkeitszeitraum seit der Erstellung in Tagen.

Typ:	Int32
Aliase:	ImmutabilityPeriodSinceCreationInDays
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Containername

Typ:	PSImmutabilityPolicy
Aliase:	ImmutabilityPolicy
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ResourceGroupName

Ressourcengruppenname.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-StorageAccount

Speicherkontoobjekt

Typ:	PSStorageAccount
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-StorageAccountName

Speicherkontoname.

Typ:	String
Aliase:	AccountName
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Ausgaben