Set-AzRmStorageContainerImmutabilityPolicy
Crea o actualiza ImmutabilityPolicy de un contenedor de blobs de Storage
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
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
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
$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
$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
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 los bloques existentes no se pueden modificar ni eliminar. "-AllowProtectedAppendWrites" y "-AllowProtectedAppendWritesAll" son mutuamente excluyentes.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 los bloques existentes no se pueden modificar ni eliminar. Esta propiedad no se puede cambiar con ExtendImmutabilityPolicy API. "-AllowProtectedAppendWrites" y "-AllowProtectedAppendWritesAll" son mutuamente excluyentes.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Container
Objeto contenedor de almacenamiento
Type: | PSContainer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerName
Nombre del contenedor
Type: | String |
Aliases: | N |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Etag
Etiqueta de directiva de inmutabilidad. Si no se especifica -ExtendPolicy, Etag es opcional; else Etag es obligatorio.
Type: | String |
Aliases: | IfMatch |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendPolicy
Indique ExtendPolicy para extender una directiva de inmutabilidad existente. Después de bloquear ImmutabilityPolicy, solo se puede extender.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutabilityPeriod
Período de inmutabilidad desde la creación en días.
Type: | Int32 |
Aliases: | ImmutabilityPeriodSinceCreationInDays |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Nombre del contenedor
Type: | PSImmutabilityPolicy |
Aliases: | ImmutabilityPolicy |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Nombre del grupo de recursos.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccount
Objeto de cuenta de almacenamiento
Type: | PSStorageAccount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Nombre de la cuenta de almacenamiento.
Type: | String |
Aliases: | AccountName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |