Dela via


Set-AzRmStorageContainerImmutabilityPolicy

Skapar eller uppdaterar ImmutabilityPolicy för en lagringsblobcontainer

Syntax

AccountName (Standard)

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

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.

Parameteregenskaper

Typ:Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AccountName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
AccountObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ContainerObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ImmutabilityPolicyObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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ä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. Det går inte att ändra den här egenskapen med ExtendImmutabilityPolicy API. "-AllowProtectedAppendWrites" och "-AllowProtectedAppendWritesAll" är ömsesidigt uteslutande.

Parameteregenskaper

Typ:Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AccountName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
AccountObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ContainerObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ImmutabilityPolicyObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Container

Lagringscontainerobjekt

Parameteregenskaper

Typ:PSContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ContainerObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendContainerObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ContainerName

Containernamn

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:N

Parameteruppsättningar

AccountName
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendAccountName
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
AccountObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendAccountObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Etag

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:IfMatch

Parameteruppsättningar

AccountName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
AccountObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ContainerObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ExtendPolicy

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ExtendAccountName
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ExtendAccountObject
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ExtendContainerObject
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ExtendImmutabilityPolicyObject
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ImmutabilityPeriod

Oföränderlighetsperiod sedan den skapades i dagar.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:OföränderlighetPeriodSinceCreationInDays

Parameteruppsättningar

AccountName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
AccountObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ContainerObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ImmutabilityPolicyObject
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InputObject

Containernamn

Parameteregenskaper

Typ:PSImmutabilityPolicy
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:OföränderlighetPolicy

Parameteruppsättningar

ImmutabilityPolicyObject
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendImmutabilityPolicyObject
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceGroupName

Namn på resursgrupp.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AccountName
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendAccountName
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-StorageAccount

Lagringskontoobjekt

Parameteregenskaper

Typ:PSStorageAccount
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AccountObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendAccountObject
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-StorageAccountName

Lagringskontonamn.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:KontoNamn

Parameteruppsättningar

AccountName
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
ExtendAccountName
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Utdata

PSImmutabilityPolicy