Set-AzRmStorageContainerImmutabilityPolicy

Skapar eller uppdaterar ImmutabilityPolicy för en lagringsblobcontainer

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

Cmdleten Set-AzRmStorageContainerImmutabilityPolicy skapar eller uppdaterar ImmutabilityPolicy för en lagringsblobcontainer

Exempel

Exempel 1: Skapa eller uppdatera ImmutabilityPolicy för en lagringsblobcontainer med lagringskontonamn och containernamn

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

Det här kommandot skapar eller uppdaterar ImmutabilityPolicy för en lagringsblobcontainer med lagringskontots namn och containernamn.

Exempel 2: Utöka ImmutabilityPolicy för en lagringsblobcontainer med lagringskontoobjekt

$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

Det här kommandot utökar ImmutabilityPolicy för en lagringsblobcontainer med Lagringskontoobjekt. Utöka ImmutabilityPolicy kan bara köras när ImmutabilityPolicy har låsts.

Exempel 3: Uppdatera ImmutabilityPolicy för en lagringsblobcontainer

$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

Det här kommandot uppdaterar ImmutabilityPolicy för en lagringsblobcontainer med Lagringscontainerobjekt 3 gånger: Först till ImmutabilityPeriod 12 dagar utan etag, sedan till ImmutabilityPeriod 9 dagar med etag och sedan aktiverat AllowProtectedAppendWrite, slutligen aktiverat AllowProtectedAppendWriteAll.

Exempel 4: Utöka ImmutabilityPolicy för en lagringsblobcontainer med ImmutabilityPolicy-objekt

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

Det här kommandot utökar ImmutabilityPolicy för en lagringsblobcontainer med ImmutabilityPolicy-objekt. Utöka ImmutabilityPolicy kan bara köras när ImmutabilityPolicy har låsts.

Parametrar

-AllowProtectedAppendWrite

Den här egenskapen kan bara ändras för olåst tidsbaserade kvarhållningsprinciper. Med den här egenskapen aktiverad kan nya block skrivas till en tilläggsblob samtidigt som oföränderligt skydd och efterlevnad upprätthålls. Det går bara att lägga till nya block och befintliga block kan inte ändras eller tas bort. "-AllowProtectedAppendWrites" och "-AllowProtectedAppendWritesAll" är ömsesidigt uteslutande.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowProtectedAppendWriteAll

Den här egenskapen kan bara ändras för olåst principer. När de är aktiverade kan nya block skrivas till både "Tilläggs- och blockblobar" samtidigt som oföränderlighetsskydd och efterlevnad upprätthålls. Det går bara att lägga till nya block och befintliga block kan inte ändras eller tas bort. Det går inte att ändra den här egenskapen med ExtendImmutabilityPolicy API. "-AllowProtectedAppendWrites" och "-AllowProtectedAppendWritesAll" är ömsesidigt uteslutande.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Lagringscontainerobjekt

Type:PSContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ContainerName

Containernamn

Type:String
Aliases:N
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Etag

Etag för oföränderlighetsprincip. Om -ExtendPolicy inte har angetts är Etag valfritt. else Etag krävs.

Type:String
Aliases:IfMatch
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExtendPolicy

Ange ExtendPolicy för att utöka en befintlig ImmutabilityPolicy. När ImmutabilityPolicy har låsts kan den bara utökas.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ImmutabilityPeriod

Oföränderlighetsperiod sedan den skapades i dagar.

Type:Int32
Aliases:ImmutabilityPeriodSinceCreationInDays
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Containernamn

Type:PSImmutabilityPolicy
Aliases:ImmutabilityPolicy
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Namnet på resursgruppen.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccount

Lagringskontoobjekt

Type:PSStorageAccount
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Lagringskontonamn.

Type:String
Aliases:AccountName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Utdata

PSImmutabilityPolicy