Set-AzRmStorageContainerImmutabilityPolicy
Cria ou atualiza a Política de Imutabilidade de um contêiner de blob de armazenamento
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
O cmdlet Set-AzRmStorageContainerImmutabilityPolicy cria ou atualiza ImmutabilityPolicy de contêineres de blob de armazenamento
Exemplos
Exemplo 1: Criar ou atualizar ImmutabilityPolicy de um contêiner de blob de armazenamento com nome de conta de armazenamento e nome de contêiner
Set-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName "myResourceGroup" -AccountName "myStorageAccount" -ContainerName "myContainer" -ImmutabilityPeriod 10
Este comando cria ou atualiza ImmutabilityPolicy de um contêiner de blob de armazenamento com nome de conta de armazenamento e nome de contêiner.
Exemplo 2: Estender ImmutabilityPolicy 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. Estender ImmutabilidadePolítica só pode ser executado depois que ImmutabilityPolicy é bloqueado.
Exemplo 3: Atualizar a Política de Imutabilidade 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, depois habilitou AllowProtectedAppendWrite, finalmente habilitou 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. Estender ImmutabilidadePolítica só pode ser executado depois que ImmutabilityPolicy é bloqueado.
Parâmetros
-AllowProtectedAppendWrite
Essa propriedade só pode ser alterada para políticas de retenção baseadas em tempo desbloqueadas. Com essa propriedade habilitada, novos blocos podem ser gravados em um blob de acréscimo, mantendo a proteção e a conformidade de imutabilidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos. '-AllowProtectedAppendWrites' e '-AllowProtectedAppendWritesAll' são mutuamente exclusivos.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowProtectedAppendWriteAll
Essa propriedade só pode ser alterada para políticas desbloqueadas. Quando habilitados, novos blocos podem ser gravados em "Appened e Block Blobs", mantendo a proteção e a conformidade de imutabilidade. Somente novos blocos podem ser adicionados e os blocos existentes não podem ser modificados ou excluídos. Essa propriedade não pode ser alterada com a API ExtendImmutabilityPolicy. '-AllowProtectedAppendWrites' e '-AllowProtectedAppendWritesAll' são mutuamente exclusivos.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Container
Objeto de contêiner de armazenamento
Type: | PSContainer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ContainerName
Nome do contêiner
Type: | String |
Aliases: | N |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Etag
Política de imutabilidade etag. Se -ExtendPolicy não for especificado, Etag será opcional; caso contrário, Etag é necessário.
Type: | String |
Aliases: | IfMatch |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtendPolicy
Indique ExtendPolicy para estender uma ImmutabilityPolicy existente. Depois que ImmutabilityPolicy é bloqueado, ele só pode ser estendido.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmutabilityPeriod
Período de imutabilidade desde a criação em dias.
Type: | Int32 |
Aliases: | ImmutabilityPeriodSinceCreationInDays |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Nome do contêiner
Type: | PSImmutabilityPolicy |
Aliases: | ImmutabilityPolicy |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Nome do grupo de recursos.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccount
Objeto de conta de armazenamento
Type: | PSStorageAccount |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountName
Nome da conta de armazenamento.
Type: | String |
Aliases: | AccountName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Saídas
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de