Set-AzRmStorageContainerImmutabilityPolicy

Odwołanie

Moduł:: Az.Storage

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

Typ:	Boolean
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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ą.

Typ:	Boolean
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Container

Obiekt kontenera magazynu

Typ:	PSContainer
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ContainerName

Nazwa kontenera

Typ:	String
Aliasy:	N
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Etag

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

Typ:	String
Aliasy:	IfMatch
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ExtendPolicy

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ImmutabilityPeriod

Okres niezmienności od utworzenia w dniach.

Typ:	Int32
Aliasy:	ImmutabilityPeriodSinceCreationInDays
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Nazwa kontenera

Typ:	PSImmutabilityPolicy
Aliasy:	ImmutabilityPolicy
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:	String
Position:	0
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-StorageAccount

Obiekt konta magazynu

Typ:	PSStorageAccount
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-StorageAccountName

Nazwa konta magazynu.

Typ:	String
Aliasy:	AccountName
Position:	1
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-WhatIf

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

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

String

PSStorageAccount

PSContainer

PSImmutabilityPolicy

Dane wyjściowe