Leer en inglés

Compartir a través de

Set-AzRmStorageContainerImmutabilityPolicy

  • Referencia
Módulo:
Az.Storage

Crea o actualiza ImmutabilityPolicy de un contenedor de blobs de Storage

Sintaxis

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

Description

El cmdlet Set-AzRmStorageContainerImmutabilityPolicy crea o actualiza ImmutabilityPolicy de un contenedor de blobs de Storage.

Ejemplos

Ejemplo 1: Creación o actualización de ImmutabilityPolicy de un contenedor de blobs de Storage con el nombre de la cuenta de Storage y el nombre del contenedor

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

Este comando crea o actualiza ImmutabilityPolicy de un contenedor de blobs de Storage con el nombre de la cuenta de Storage y el nombre del contenedor.

Ejemplo 2: Extender la inmutabilidadPolicy de un contenedor de blobs de Storage, con el objeto de cuenta de almacenamiento

PowerShell 
$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

Este comando extiende ImmutabilityPolicy de un contenedor de blobs de Storage, con el objeto de cuenta de almacenamiento. Extend ImmutabilityPolicy solo se puede ejecutar después de que ImmutabilityPolicy esté bloqueado.

Ejemplo 3: Actualización de ImmutabilityPolicy de un contenedor de blobs de Storage

PowerShell 
$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

Este comando actualiza ImmutabilityPolicy de un contenedor de blobs de Storage con el objeto contenedor de Storage 3 veces: Primero en ImmutabilityPeriod 12 días sin etag, a continuación, a ImmutabilityPeriod 9 días con etag y, a continuación, habilitado AllowProtectedAppendWrite, finalmente habilitado AllowProtectedAppendWriteAll.

Ejemplo 4: Extensión de immutabilidadPolicy de un contenedor de blobs de Storage, con el objeto ImmutabilityPolicy

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

Este comando extiende ImmutabilityPolicy de un contenedor de blobs de Storage, con el objeto ImmutabilityPolicy. Extend ImmutabilityPolicy solo se puede ejecutar después de que ImmutabilityPolicy esté bloqueado.

Parámetros

-AllowProtectedAppendWrite

Esta propiedad solo se puede cambiar para las directivas de retención basadas en tiempo desbloqueadas. Con esta propiedad habilitada, los nuevos bloques se pueden escribir en un blob en anexos al tiempo que se mantiene la protección y el cumplimiento de la inmutabilidad. Solo se pueden agregar nuevos bloques y no se pueden modificar ni eliminar los bloques existentes. "-AllowProtectedAppendWrites" y "-AllowProtectedAppendWritesAll" son mutuamente excluyentes.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AllowProtectedAppendWriteAll

Esta propiedad solo se puede cambiar para las directivas desbloqueadas. Cuando se habilita, los nuevos bloques se pueden escribir en "Appened y Block Blobs" al tiempo que se mantiene la protección y el cumplimiento de la inmutabilidad. Solo se pueden agregar nuevos bloques y no se pueden modificar ni eliminar los bloques existentes. Esta propiedad no se puede cambiar con ExtendImmutabilityPolicy API. "-AllowProtectedAppendWrites" y "-AllowProtectedAppendWritesAll" son mutuamente excluyentes.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Container

Objeto contenedor de almacenamiento

Tipo:PSContainer
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ContainerName

Nombre del contenedor

Tipo:String
Alias:N
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Etag

Etiqueta de directiva de inmutabilidad. Si no se especifica -ExtendPolicy, Etag es opcional; else Etag es obligatorio.

Tipo:String
Alias:IfMatch
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExtendPolicy

Indique ExtendPolicy para extender una directiva de inmutabilidad existente. Después de bloquear ImmutabilityPolicy, solo se puede extender.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImmutabilityPeriod

Período de inmutabilidad desde la creación en días.

Tipo:Int32
Alias:ImmutabilityPeriodSinceCreationInDays
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Nombre del contenedor

Tipo:PSImmutabilityPolicy
Alias:ImmutabilityPolicy
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccount

Objeto de cuenta de almacenamiento

Tipo:PSStorageAccount
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountName

Nombre de la cuenta de almacenamiento.

Tipo:String
Alias:AccountName
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Salidas