Partilhar via


Set-AzRmStorageContainerImmutabilityPolicy

Cria ou atualiza a Política de Imutabilidade de um contêiner de blob de armazenamento

Sintaxe

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

O cmdlet Set-AzRmStorageContainerImmutabilityPolicy cria ou atualiza ImmutabilityPolicy de um contêiner de blob de armazenamento

Exemplos

Exemplo 1: Criar ou atualizar ImmutabilidadePolítica de um contêiner de blob de armazenamento com Nome da conta de armazenamento e nome do contêiner

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

Este comando cria ou atualiza a Política de Imutabilidade de um contêiner de blob de armazenamento com o nome da conta de armazenamento e o nome do contêiner.

Exemplo 2: Estender ImmutabilidadePolítica de um contêiner de blob de armazenamento, com objeto de conta de armazenamento

$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 estende ImmutabilityPolicy de um contêiner de blob de armazenamento, com o objeto de conta de armazenamento. Extend ImmutabilityPolicy só pode ser executado depois que ImmutabilityPolicy estiver bloqueado.

Exemplo 3: Atualizar ImmutabilidadePolítica de um contêiner de blob de armazenamento

$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 atualiza ImmutabilityPolicy de um contêiner de blob de armazenamento com objeto de contêiner de armazenamento 3 vezes: primeiro para ImmutabilityPeriod 12 dias sem etag, depois para ImmutabilityPeriod 9 dias com etag, em seguida, habilitado AllowProtectedAppendWrite, finalmente habilitado AllowProtectedAppendWriteAll.

Exemplo 4: Estender ImmutabilityPolicy de um contêiner de blob de armazenamento, com o objeto ImmutabilityPolicy

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

Este comando estende ImmutabilityPolicy de um contêiner de blob de armazenamento, com o objeto ImmutabilityPolicy. Extend ImmutabilityPolicy só pode ser executado depois que ImmutabilityPolicy estiver bloqueado.

Parâmetros

-AllowProtectedAppendWrite

Essa propriedade só pode ser alterada para políticas de retenção com base no tempo desbloqueadas. Com essa propriedade habilitada, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade da imutabilidade. Apenas novos blocos podem ser adicionados e quaisquer blocos existentes não podem ser modificados ou excluídos. '-AllowProtectedAppendWrites' e '-AllowProtectedAppendWritesAll' são mutuamente exclusivos.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllowProtectedAppendWriteAll

Esta propriedade só pode ser alterada para políticas desbloqueadas. Quando ativados, os novos blocos podem ser gravados em 'Appened e Block Blobs', mantendo a proteção e a conformidade da imutabilidade. Apenas novos blocos podem ser adicionados e quaisquer blocos existentes não podem ser modificados ou excluídos. Esta propriedade não pode ser alterada com a API ExtendImmutabilityPolicy. '-AllowProtectedAppendWrites' e '-AllowProtectedAppendWritesAll' são mutuamente exclusivos.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Container

Objeto de contêiner de armazenamento

Tipo:PSContainer
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ContainerName

Nome do contêiner

Tipo:String
Aliases:N
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Etag

Política de imutabilidade etag. Se -ExtendPolicy não for especificado, Etag é opcional; caso contrário, Etag é necessário.

Tipo:String
Aliases:IfMatch
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExtendPolicy

Indique ExtendPolicy para Estender uma ImmutabilityPolicy existente. Depois que a ImmutabilityPolicy for bloqueada, ela só poderá ser estendida.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ImmutabilityPeriod

Período de imutabilidade desde a criação em dias.

Tipo:Int32
Aliases:ImmutabilityPeriodSinceCreationInDays
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Nome do contêiner

Tipo:PSImmutabilityPolicy
Aliases:ImmutabilityPolicy
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Nome do Grupo de Recursos.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageAccount

Objeto da conta de armazenamento

Tipo:PSStorageAccount
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageAccountName

Nome da conta de armazenamento.

Tipo:String
Aliases:AccountName
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Saídas

PSImmutabilityPolicy