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ügebb geschrieben werden, während Standard 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. "-AllowProtectedAppendWrites" und "-AllowProtectedAppendWritesAll" schließen sich gegenseitig aus.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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, während Standard 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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

Speichercontainerobjekt

Type:	PSContainer
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ContainerName

Containername

Type:	String
Aliases:	N
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Etag

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

Type:	String
Aliases:	IfMatch
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtendPolicy

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImmutabilityPeriod

Unveränderlichkeitszeitraum seit der Erstellung in Tagen.

Type:	Int32
Aliases:	ImmutabilityPeriodSinceCreationInDays
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Containername

Type:	PSImmutabilityPolicy
Aliases:	ImmutabilityPolicy
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Ressourcengruppenname.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccount

Speicherkontoobjekt

Type:	PSStorageAccount
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountName

Speicherkontoname.

Type:	String
Aliases:	AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Ausgaben