Dela via


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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Container

Lagringscontainerobjekt

Typ:PSContainer
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ContainerName

Containernamn

Typ:String
Alias:N
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

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

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Etag

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

Typ:String
Alias:IfMatch
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExtendPolicy

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImmutabilityPeriod

Oföränderlighetsperiod sedan den skapades i dagar.

Typ:Int32
Alias:ImmutabilityPeriodSinceCreationInDays
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Containernamn

Typ:PSImmutabilityPolicy
Alias:ImmutabilityPolicy
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Namnet på resursgruppen.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccount

Lagringskontoobjekt

Typ:PSStorageAccount
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-StorageAccountName

Lagringskontonamn.

Typ:String
Alias:AccountName
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Utdata

PSImmutabilityPolicy