Set-AzRmStorageContainerImmutabilityPolicy

Reference

Modul:: Az.Storage

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

Syntaxe

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í.

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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í.

Typ:	Boolean
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

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

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Container

Objekt kontejneru úložiště

Typ:	PSContainer
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ContainerName

Název kontejneru

Typ:	String
Aliasy:	N
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Etag

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

Typ:	String
Aliasy:	IfMatch
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ExtendPolicy

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ImmutabilityPeriod

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

Typ:	Int32
Aliasy:	ImmutabilityPeriodSinceCreationInDays
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Název kontejneru

Typ:	PSImmutabilityPolicy
Aliasy:	ImmutabilityPolicy
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ResourceGroupName

Název skupiny prostředků

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccount

Objekt účtu úložiště

Typ:	PSStorageAccount
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-StorageAccountName

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

Typ:	String
Aliasy:	AccountName
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

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

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Výstupy