Partilhar via


Set-AzRmStorageContainerImmutabilityPolicy

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

Sintaxe

AccountName (Predefinição)

Set-AzRmStorageContainerImmutabilityPolicy
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -ContainerName <String>
    [-ImmutabilityPeriod <Int32>]
    [-AllowProtectedAppendWriteAll <Boolean>]
    [-AllowProtectedAppendWrite <Boolean>]
    [-Etag <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExtendAccountName

Set-AzRmStorageContainerImmutabilityPolicy
    [-ResourceGroupName] <String>
    [-StorageAccountName] <String>
    -ContainerName <String>
    -ImmutabilityPeriod <Int32>
    -Etag <String>
    [-ExtendPolicy]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AccountObject

Set-AzRmStorageContainerImmutabilityPolicy
    -ContainerName <String>
    -StorageAccount <PSStorageAccount>
    [-ImmutabilityPeriod <Int32>]
    [-AllowProtectedAppendWriteAll <Boolean>]
    [-AllowProtectedAppendWrite <Boolean>]
    [-Etag <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExtendAccountObject

Set-AzRmStorageContainerImmutabilityPolicy
    -ContainerName <String>
    -StorageAccount <PSStorageAccount>
    -ImmutabilityPeriod <Int32>
    -Etag <String>
    [-ExtendPolicy]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerObject

Set-AzRmStorageContainerImmutabilityPolicy
    -Container <PSContainer>
    [-ImmutabilityPeriod <Int32>]
    [-AllowProtectedAppendWriteAll <Boolean>]
    [-AllowProtectedAppendWrite <Boolean>]
    [-Etag <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExtendContainerObject

Set-AzRmStorageContainerImmutabilityPolicy
    -Container <PSContainer>
    -ImmutabilityPeriod <Int32>
    -Etag <String>
    [-ExtendPolicy]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ImmutabilityPolicyObject

Set-AzRmStorageContainerImmutabilityPolicy
    [-InputObject] <PSImmutabilityPolicy>
    [-ImmutabilityPeriod <Int32>]
    [-AllowProtectedAppendWriteAll <Boolean>]
    [-AllowProtectedAppendWrite <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ExtendImmutabilityPolicyObject

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.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

AccountName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ContainerObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ImmutabilityPolicyObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AllowProtectedAppendWriteAll

Esta propriedade só pode ser alterada para políticas desbloqueadas. Quando ativados, novos blocos podem ser gravados em 'Acrescentar e Bloquear 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.

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

AccountName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ContainerObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ImmutabilityPolicyObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Container

Objeto de contêiner de armazenamento

Propriedades dos parâmetros

Tipo:PSContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ContainerObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendContainerObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ContainerName

Nome do contêiner

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:N

Conjuntos de parâmetros

AccountName
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendAccountName
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
AccountObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendAccountObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Etag

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IfMatch

Conjuntos de parâmetros

AccountName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ContainerObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ExtendPolicy

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ExtendAccountName
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ExtendAccountObject
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ExtendContainerObject
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ExtendImmutabilityPolicyObject
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ImmutabilityPeriod

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ImutabilidadePeríodoDesdeCriaçãoInDias

Conjuntos de parâmetros

AccountName
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
AccountObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ContainerObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False
ImmutabilityPolicyObject
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

Nome do contêiner

Propriedades dos parâmetros

Tipo:PSImmutabilityPolicy
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Política de Imutabilidade

Conjuntos de parâmetros

ImmutabilityPolicyObject
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendImmutabilityPolicyObject
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceGroupName

Nome do Grupo de Recursos.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

AccountName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendAccountName
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StorageAccount

Objeto da conta de armazenamento

Propriedades dos parâmetros

Tipo:PSStorageAccount
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

AccountObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendAccountObject
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StorageAccountName

Nome da conta de armazenamento.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome da Conta

Conjuntos de parâmetros

AccountName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ExtendAccountName
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Saídas

PSImmutabilityPolicy