Set-AzRmStorageContainerImmutabilityPolicy

Tworzy lub aktualizuje niezmiennośćZasady kontenerów obiektów blob usługi Storage

Składnia

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

Opis

Polecenie cmdlet Set-AzRmStorageContainerImmutabilityPolicy tworzy lub aktualizuje zasady Niezmienności kontenerów obiektów blob usługi Storage

Przykłady

Przykład 1. Tworzenie lub aktualizowanie wartości ImmutabilityPolicy kontenera obiektów blob usługi Storage przy użyciu nazwy konta usługi Storage i nazwy kontenera

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

To polecenie tworzy lub aktualizuje wartość ImmutabilityPolicy kontenera obiektów blob usługi Storage z nazwą konta magazynu i nazwą kontenera.

Przykład 2. Rozszerzanie obiektu ImmutabilityPolicy kontenera obiektów blob usługi Storage przy użyciu obiektu konta magazynu

$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

To polecenie rozszerza wartość ImmutabilityPolicy kontenera obiektów blob usługi Storage za pomocą obiektu konta magazynu. Rozszerzenie ImmutabilityPolicy może działać tylko po zablokowaniu zasady Niezmienności.

Przykład 3. Aktualizacja elementu ImmutabilityPolicy kontenera obiektów blob usługi Storage

$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

To polecenie aktualizuje element ImmutabilityPolicy kontenera obiektów blob usługi Storage z obiektem kontenera usługi Storage 3 razy: najpierw do wartości ImmutabilityPeriod 12 dni bez elementu etag, a następnie do elementu ImmutabilityPeriod 9 dni za pomocą elementu etag, a następnie włączone allowProtectedAppendWrite, na koniec włączone AllowProtectedAppendWriteAll.

Przykład 4. Rozszerzanie obiektu ImmutabilityPolicy kontenera obiektów blob usługi Storage przy użyciu obiektu ImmutabilityPolicy

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

To polecenie rozszerza wartość ImmutabilityPolicy kontenera obiektów blob usługi Storage za pomocą obiektu ImmutabilityPolicy. Rozszerzenie ImmutabilityPolicy może działać tylko po zablokowaniu zasady Niezmienności.

Parametry

-AllowProtectedAppendWrite

Tę właściwość można zmienić tylko dla odblokowanych zasad przechowywania na podstawie czasu. Po włączeniu tej właściwości nowe bloki można zapisywać w uzupełnialnych obiektach blob przy zachowaniu niezmienności ochrony i zgodności. Można dodawać tylko nowe bloki i nie można modyfikować ani usuwać żadnych istniejących bloków. "-AllowProtectedAppendWrites" i "-AllowProtectedAppendWritesAll" wzajemnie się wykluczają.

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

-AllowProtectedAppendWriteAll

Tę właściwość można zmienić tylko dla odblokowanych zasad. Po włączeniu nowych bloków można zapisywać zarówno w obiektach "Appened, jak i Block Blob" przy zachowaniu niezmienności i zgodności. Można dodawać tylko nowe bloki i nie można modyfikować ani usuwać żadnych istniejących bloków. Tej właściwości nie można zmienić za pomocą interfejsu API ExtendImmutabilityPolicy. "-AllowProtectedAppendWrites" i "-AllowProtectedAppendWritesAll" wzajemnie się wykluczają.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Container

Obiekt kontenera magazynu

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

-ContainerName

Nazwa kontenera

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-Etag

Etag zasad niezmienności. Jeśli parametr -ExtendPolicy nie jest określony, element Etag jest opcjonalny; else Etag jest wymagany.

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

-ExtendPolicy

Wskaż wartość ExtendPolicy, aby rozszerzyć istniejącą wartość ImmutabilityPolicy. Po zablokowaniu elementu ImmutabilityPolicy można go rozszerzyć tylko.

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

-ImmutabilityPeriod

Okres niezmienności od utworzenia w dniach.

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

-InputObject

Nazwa kontenera

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

-ResourceGroupName

Nazwa grupy zasobów.

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

-StorageAccount

Obiekt konta magazynu

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

-StorageAccountName

Nazwa konta magazynu.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Dane wyjściowe

PSImmutabilityPolicy