Partilhar via

Set-AzStorageBlobImmutabilityPolicy

  • Referência
Módulo:
Az.Storage

Cria ou atualiza a Política de Imutabilidade de um blob de armazenamento.

Sintaxe

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

O cmdlet Set-AzStorageBlobImmutabilityPolicy cria ou atualiza ImmutabilityPolicy de um blob de armazenamento. O cmdlet só funciona quando o contêiner de blob já habilitou o armazenamento imutável com controle de versão.

Exemplos

Exemplo 1: Criar ou atualizar a política de imutabilidade de um blob de armazenamento.

$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

Este comando cria ou atualiza ImmutabilityPolicy de um blob de armazenamento e, em seguida, mostra o blob e sua ImmutabilityPolicy. O comando só funciona quando o contêiner de blob já tiver habilitado o armazenamento imutável com controle de versão.

Parâmetros

-Blob

Nome do blob

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BlobBaseClient

Objeto BlobBaseClient

Tipo:BlobBaseClient
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ClientTimeoutPerRequest

O tempo máximo de execução do lado do cliente para cada solicitação em segundos.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConcurrentTaskCount

A quantidade total de tarefas assíncronas simultâneas. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Container

Nome do contêiner

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Context

Objeto de contexto de armazenamento do Azure

Tipo:IStorageContext
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExpiresOn

A política de imutabilidade de blob expira

Tipo:Nullable<T>[DateTimeOffset]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PolicyMode

Imutabilidade de BlobPolicyPolicy Mode

Tipo:String
Valores aceites:Unlocked, Locked, Mutable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServerTimeoutPerRequest

O tempo limite do servidor para cada solicitação em segundos.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TagCondition

Instrução de expressão de tag opcional para verificar a condição de correspondência. A solicitação de blob falhará quando as tags de blob não corresponderem à expressão fornecida. Veja detalhes em https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

Saídas