Set-AzRmStorageContainerImmutabilityPolicy

Vytvoří nebo aktualizuje ImmutabilityPolicy kontejnerů objektů blob služby Storage.

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

Rutina Set-AzRmStorageContainerImmutabilityPolicy vytvoří nebo aktualizuje ImmutabilityPolicy kontejnerů objektů blob služby Storage.

Příklady

Příklad 1: Vytvoření nebo aktualizace ImmutabilityPolicy kontejneru objektů blob úložiště s názvem účtu úložiště a názvem kontejneru

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

Tento příkaz vytvoří nebo aktualizuje ImmutabilityPolicy kontejneru objektů blob úložiště s názvem účtu úložiště a názvem kontejneru.

Příklad 2: Rozšíření ImmutabilityPolicy kontejneru objektů blob úložiště s objektem účtu úložiště

$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

Tento příkaz rozšiřuje ImmutabilityPolicy kontejneru objektů blob úložiště s objektem účtu úložiště. Rozšíření ImmutabilityPolicy se může spustit pouze po uzamčení ImmutabilityPolicy.

Příklad 3: Aktualizace immutabilityPolicy kontejneru objektů blob úložiště

$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

Tento příkaz aktualizuje ImmutabilityPolicy kontejneru objektů blob úložiště s objektem kontejneru služby Storage 3 krát: Nejprve na ImmutabilityPeriod 12 dní bez značky etag, pak na ImmutabilityPeriod 9 dní s etag, potom povolit AllowProtectedAppendWrite, nakonec povolit AllowProtectedAppendWriteAll.

Příklad 4: Rozšíření ImmutabilityPolicy kontejneru objektů blob úložiště s objektem ImmutabilityPolicy

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

Tento příkaz rozšiřuje ImmutabilityPolicy kontejneru objektů blob služby Storage s objektem ImmutabilityPolicy. Rozšíření ImmutabilityPolicy se může spustit pouze po uzamčení ImmutabilityPolicy.

Parametry

-AllowProtectedAppendWrite

Tuto vlastnost lze změnit pouze pro odemknuté zásady uchovávání informací na základě času. Když je tato vlastnost povolená, dají se nové bloky zapsat do doplňovacího objektu blob při zachování neměnnosti a dodržování předpisů. Je možné přidat pouze nové bloky a všechny existující bloky nelze upravit ani odstranit. -AllowProtectedAppendWrites a-AllowProtectedAppendWritesAll se vzájemně vylučují.

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

-AllowProtectedAppendWriteAll

Tuto vlastnost lze změnit pouze u odemknutých zásad. Pokud je tato možnost povolená, dají se nové bloky zapsat do objektů blob appened i objektů blob bloku při zachování neměnnosti ochrany a dodržování předpisů. Je možné přidat pouze nové bloky a všechny existující bloky nelze upravit ani odstranit. Tuto vlastnost nelze změnit pomocí rozhraní API ExtendImmutabilityPolicy. -AllowProtectedAppendWrites a-AllowProtectedAppendWritesAll se vzájemně vylučují.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Container

Objekt kontejneru úložiště

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

-ContainerName

Název kontejneru

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

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

-Etag

Immutability policy etag. Pokud není zadán parametr -ExtendPolicy, je etag nepovinný; else Etag je povinný.

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

-ExtendPolicy

Naznačte ExtendPolicy pro rozšíření existující immutabilityPolicy. Po uzamčení ImmutabilityPolicy je možné ji rozšířit pouze.

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

-ImmutabilityPeriod

Období neměnnosti od vytvoření ve dnech.

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

-InputObject

Název kontejneru

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

-ResourceGroupName

Název skupiny prostředků

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

-StorageAccount

Objekt účtu úložiště

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

-StorageAccountName

Název účtu úložiště

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Výstupy

PSImmutabilityPolicy