Sdílet prostřednictvím


Set-AzStorageBlobImmutabilityPolicy

Vytvoří nebo aktualizuje ImmutabilityPolicy objektu blob úložiště.

Syntaxe

Set-AzStorageBlobImmutabilityPolicy
   [-Blob] <String>
   [-Container] <String>
   -ExpiresOn <DateTimeOffset>
   [-PolicyMode <String>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzStorageBlobImmutabilityPolicy
   -BlobBaseClient <BlobBaseClient>
   -ExpiresOn <DateTimeOffset>
   [-PolicyMode <String>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzStorageBlobImmutabilityPolicy vytvoří nebo aktualizuje ImmutabilityPolicy objektu blob úložiště. Rutina funguje jenom v případech, kdy už kontejner objektů blob povolil neměnné úložiště s verzí.

Příklady

Příklad 1: Vytvoření nebo aktualizace zásad neměnnosti objektu blob úložiště

$blob = Set-AzStorageBlobImmutabilityPolicy -Container $containerName -Blob $blobname  -ExpiresOn (Get-Date).AddDays(100) -PolicyMode Unlocked

$blob

   AccountName: mystorageaccount, ContainerName: mycontainer

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 10485760        application/octet-stream       2021-07-19 08:56:00Z Hot                                     False      2021-07-19T08:56:01.8120788Z *   

$blob.BlobProperties.ImmutabilityPolicy

ExpiresOn                    PolicyMode
---------                    ----------
10/27/2021 8:56:32 AM +00:00   Unlocked

Tento příkaz vytvoří nebo aktualizuje ImmutabilityPolicy objektu blob úložiště a pak objekt blob a jeho ImmutabilityPolicy. Příkaz funguje jenom v případech, kdy kontejner objektů blob už povolil neměnné úložiště s verzí.

Parametry

-Blob

Název objektu blob

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

-BlobBaseClient

Objekt BlobBaseClient

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

-ClientTimeoutPerRequest

Maximální doba provádění na straně klienta pro každý požadavek v sekundách.

Typ:Nullable<T>[Int32]
Aliasy:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConcurrentTaskCount

Celkový počet souběžných asynchronních úloh. Výchozí hodnota je 10.

Typ:Nullable<T>[Int32]
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 vás vyzve 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

Název kontejneru

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

-Context

Kontextový objekt služby Azure Storage

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

-ExpiresOn

Blob ImmutabilityPolicy ExpiresOn

Typ:Nullable<T>[DateTimeOffset]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PolicyMode

Blob ImmutabilityPolicy PolicyMode

Typ:String
Přípustné hodnoty:Unlocked, Locked, Mutable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerTimeoutPerRequest

Časový limit serveru pro každý požadavek v sekundách vypršel.

Typ:Nullable<T>[Int32]
Aliasy:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TagCondition

Volitelný příkaz výrazu Tag pro kontrolu podmínky shody. Požadavek na objekt blob selže, pokud značky objektů blob neodpovídají danému výrazu. Podrobnosti najdete v https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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

BlobBaseClient

IStorageContext

Výstupy

AzureStorageBlob