Set-AzRmStorageContainerImmutabilityPolicy

Référence

Module:: Az.Storage

Crée ou met à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage

Syntaxe

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

L’applet de commande Set-AzRmStorageContainerImmutabilityPolicy crée ou met à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage

Exemples

Exemple 1 : Créer ou mettre à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage avec le nom du compte de stockage et le nom du conteneur

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

Cette commande crée ou met à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage avec le nom du compte de stockage et le nom du conteneur.

Exemple 2 : Étendre ImmutabilityPolicy d’un conteneur d’objets blob de stockage, avec un objet de compte de stockage

$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

Cette commande étend ImmutabilityPolicy d’un conteneur d’objets blob de stockage, avec l’objet compte de stockage. Étendre ImmutabilityPolicy ne peut s’exécuter qu’une fois ImmutabilityPolicy verrouillée.

Exemple 3 : Mettre à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage

$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

Cette commande met à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage avec l’objet conteneur de stockage 3 fois : Commencez par ImmutabilityPeriod 12 jours sans etag, puis vers ImmutabilityPeriod 9 jours avec etag, puis activez AllowProtectedAppendWrite, enfin activé AllowProtectedAppendWriteAll.

Exemple 4 : Étendre ImmutabilityPolicy d’un conteneur d’objets blob de stockage, avec un objet ImmutabilityPolicy

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

Cette commande étend ImmutabilityPolicy d’un conteneur d’objets blob de stockage, avec un objet ImmutabilityPolicy. Étendre ImmutabilityPolicy ne peut s’exécuter qu’une fois ImmutabilityPolicy verrouillée.

Paramètres

-AllowProtectedAppendWrite

Cette propriété ne peut être modifiée que pour les stratégies de rétention basées sur le temps déverrouillées. Avec cette propriété activée, de nouveaux blocs peuvent être écrits dans un objet blob d’ajout tout en conservant la protection et la conformité immuabilité. Seuls de nouveaux blocs peuvent être ajoutés et les blocs existants ne peuvent pas être modifiés ou supprimés. « -AllowProtectedAppendWrites » et « -AllowProtectedAppendWritesAll » s’excluent mutuellement.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AllowProtectedAppendWriteAll

Cette propriété ne peut être modifiée que pour les stratégies déverrouillées. Lorsqu’ils sont activés, de nouveaux blocs peuvent être écrits dans « Appened et Block Blobs » tout en conservant la protection et la conformité immuabilité. Seuls de nouveaux blocs peuvent être ajoutés et les blocs existants ne peuvent pas être modifiés ou supprimés. Cette propriété ne peut pas être modifiée avec l’API ExtendImmutabilityPolicy. « -AllowProtectedAppendWrites » et « -AllowProtectedAppendWritesAll » s’excluent mutuellement.

Type:	Boolean
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Container

Objet conteneur de stockage

Type:	PSContainer
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ContainerName

Nom du conteneur

Type:	String
Alias:	N
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Etag

Stratégie d’immuabilité etag. Si -ExtendPolicy n’est pas spécifié, Etag est facultatif ; else Etag est obligatoire.

Type:	String
Alias:	IfMatch
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ExtendPolicy

Indiquez ExtendPolicy pour étendre une immuabilitéPolicy existante. Une fois ImmutabilityPolicy verrouillée, elle ne peut être étendue que.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ImmutabilityPeriod

Période d’immuabilité depuis la création en jours.

Type:	Int32
Alias:	ImmutabilityPeriodSinceCreationInDays
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-InputObject

Nom du conteneur

Type:	PSImmutabilityPolicy
Alias:	ImmutabilityPolicy
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ResourceGroupName

Nom du groupe de ressources.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-StorageAccount

Objet compte de stockage

Type:	PSStorageAccount
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-StorageAccountName

Nom du compte de stockage.

Type:	String
Alias:	AccountName
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Sorties