Partager via


Set-AzureRmStorageContainerImmutabilityPolicy

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

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Set-AzureRmStorageContainerImmutabilityPolicy
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-ContainerName] <String>
   -ImmutabilityPeriod <Int32>
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   [-ContainerName] <String>
   -ImmutabilityPeriod <Int32>
   -Etag <String>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   [-ContainerName] <String>
   -StorageAccount <PSStorageAccount>
   -ImmutabilityPeriod <Int32>
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   [-ContainerName] <String>
   -StorageAccount <PSStorageAccount>
   -ImmutabilityPeriod <Int32>
   -Etag <String>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   -Container <PSContainer>
   -ImmutabilityPeriod <Int32>
   [-Etag <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   -Container <PSContainer>
   -ImmutabilityPeriod <Int32>
   -Etag <String>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   -InputObject <PSImmutabilityPolicy>
   -ImmutabilityPeriod <Int32>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageContainerImmutabilityPolicy
   -InputObject <PSImmutabilityPolicy>
   -ImmutabilityPeriod <Int32>
   [-ExtendPolicy]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureRmStorageContainerImmutabilityPolicy 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

PS C:\>Set-AzureRmStorageContainerImmutabilityPolicy -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

PS C:\>$accountObject = Get-AzureRmStorageAccount -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount"
PS C:\>$policy = Get-AzureRmStorageContainerImmutabilityPolicy -StorageAccount $accountObject -ContainerName "myContainer"
PS C:\>Set-AzureRmStorageContainerImmutabilityPolicy -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 ImmutabilityPolicyof un conteneur d’objets blob de stockage

PS C:\>$containerObject = Get-AzureRmStorageContainer -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -Name "myContainer"
PS C:\>$policy = Set-AzureRmStorageContainerImmutabilityPolicy -Container $containerObject -ImmutabilityPeriod 12
PS C:\>$policy = Set-AzureRmStorageContainerImmutabilityPolicy -Container $containerObject -ImmutabilityPeriod 9 -Etag $policy.Etag

Cette commande met à jour ImmutabilityPolicy d’un conteneur d’objets blob de stockage avec l’objet conteneur de stockage 2 fois, d’abord sur ImmutabilityPeriod 12 jours sans etag, puis sur ImmutabilityPeriod 9 jours avec etag.

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

PS C:\>Get-AzureRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" | Set-AzureRmStorageContainerImmutabilityPolicy -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

-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:2
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: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:Named
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

Microsoft.Azure.Commands.Management.Storage.Models.PSImmutabilityPolicy

Sorties

PSImmutabilityPolicy