Set-AzRmStorageContainerImmutabilityPolicy

Riferimento

Modulo:: Az.Storage

Crea o aggiorna ImmutabilityPolicy di un contenitore BLOB di archiviazione

Sintassi

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>]

Descrizione

Il cmdlet Set-AzRmStorageContainerImmutabilityPolicy crea o aggiorna ImmutabilityPolicy di un contenitore BLOB di archiviazione

Esempio

Esempio 1: Creare o aggiornare ImmutabilityPolicy di un contenitore BLOB di archiviazione con nome dell'account di archiviazione e nome del contenitore

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

Questo comando crea o aggiorna ImmutabilityPolicy di un contenitore BLOB di archiviazione con nome dell'account di archiviazione e nome del contenitore.

Esempio 2: Estendere ImmutabilityPolicy di un contenitore BLOB di archiviazione con l'oggetto account di archiviazione

$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

Questo comando estende ImmutabilityPolicy di un contenitore BLOB di archiviazione, con l'oggetto Account di archiviazione. Extend ImmutabilityPolicy può essere eseguito solo dopo il blocco di ImmutabilityPolicy.

Esempio 3: Aggiornare ImmutabilityPolicy di un contenitore BLOB di archiviazione

$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

Questo comando aggiorna ImmutabilityPolicy di un contenitore BLOB di archiviazione con l'oggetto contenitore di archiviazione 3 volte: prima a ImmutabilityPeriod 12 giorni senza etag, quindi a ImmutabilityPeriod 9 giorni con etag, quindi abilitato AllowProtectedAppendWrite, infine abilitato AllowProtectedAppendWriteAll.

Esempio 4: Estendere ImmutabilityPolicy di un contenitore BLOB di archiviazione con oggetto ImmutabilityPolicy

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

Questo comando estende ImmutabilityPolicy di un contenitore BLOB di archiviazione con l'oggetto ImmutabilityPolicy. Extend ImmutabilityPolicy può essere eseguito solo dopo il blocco di ImmutabilityPolicy.

Parametri

-AllowProtectedAppendWrite

Questa proprietà può essere modificata solo per i criteri di conservazione basati sul tempo sbloccati. Con questa proprietà abilitata, è possibile scrivere nuovi blocchi in un BLOB di accodamento mantenendo al contempo la protezione e la conformità dell'immutabilità. È possibile aggiungere solo nuovi blocchi e non è possibile modificare o eliminare blocchi esistenti. '-AllowProtectedAppendWrites' e '-AllowProtectedAppendWritesAll' si escludono a vicenda.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AllowProtectedAppendWriteAll

Questa proprietà può essere modificata solo per i criteri sbloccati. Se abilitata, è possibile scrivere nuovi blocchi sia in "Appened che in BLOB in blocchi" mantenendo al tempo di non modificabilità e conformità. È possibile aggiungere solo nuovi blocchi e non è possibile modificare o eliminare blocchi esistenti. Questa proprietà non può essere modificata con l'API ExtendImmutabilityPolicy. '-AllowProtectedAppendWrites' e '-AllowProtectedAppendWritesAll' si escludono a vicenda.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Container

Oggetto contenitore di archiviazione

Tipo:	PSContainer
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ContainerName

Nome contenitore

Tipo:	String
Alias:	N
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Etag

Etag dei criteri di immutabilità. Se -ExtendPolicy non è specificato, Etag è facoltativo; else Etag è obbligatorio.

Tipo:	String
Alias:	IfMatch
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ExtendPolicy

Indicare ExtendPolicy per estendere un oggetto ImmutabilityPolicy esistente. Dopo che ImmutabilityPolicy è bloccato, può essere esteso solo.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ImmutabilityPeriod

Periodo di immutabilità dopo la creazione in giorni.

Tipo:	Int32
Alias:	ImmutabilityPeriodSinceCreationInDays
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Nome contenitore

Tipo:	PSImmutabilityPolicy
Alias:	ImmutabilityPolicy
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ResourceGroupName

Nome del gruppo di risorse.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-StorageAccount

Oggetto account di archiviazione

Tipo:	PSStorageAccount
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-StorageAccountName

Nome account di archiviazione.

Tipo:	String
Alias:	AccountName
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Output