Set-AzRmStorageContainerImmutabilityPolicy

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

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

Description

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

Exemples

Exemple 1 : Créer ou mettre à jour ImmutabilityPolicy d’un conteneur d’objets blob Stockage avec Stockage nom de compte et nom de 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 Stockage avec Stockage nom de compte et le nom du conteneur.

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

$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 Stockage, avec Stockage objet de compte. Étendre ImmutabilityPolicy ne peut s’exécuter qu’une fois ImmutabilityPolicy verrouillée.

Exemple 3 : Mettre à jour ImmutabilityPolicy d’un conteneur d’objets blob 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 Stockage avec Stockage objet conteneur 3 fois : D’abord à ImmutabilityPeriod 12 jours sans etag, puis à ImmutabilityPeriod 9 jours avec etag, puis à AllowProtectedAppendWrite, enfin activé AllowProtectedAppendWriteAll.

Exemple 4 : Étendre ImmutabilityPolicy d’un conteneur d’objets blob 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 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

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

-Container

objet conteneur Stockage

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

-ContainerName

Nom du conteneur

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

-DefaultProfile

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

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

-Etag

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

Type:String
Aliases:IfMatch
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ImmutabilityPeriod

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

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

-InputObject

Nom du conteneur

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

-ResourceGroupName

Nom du groupe de ressources.

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

-StorageAccount

objet de compte Stockage

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

-StorageAccountName

Stockage Nom du compte.

Type:String
Aliases:AccountName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Sorties

PSImmutabilityPolicy