Set-AzStorageBlobImmutabilityPolicy
Cria ou atualiza a Política de Imutabilidade de um blob de armazenamento.
Sintaxe
NamePipeline (Predefinição)
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>]
BlobPipeline
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
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NamePipeline
Position: 0
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-BlobBaseClient
Objeto BlobBaseClient
Propriedades dos parâmetros
Tipo: BlobBaseClient
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
BlobPipeline
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-ClientTimeoutPerRequest
O tempo máximo de execução do lado do cliente para cada solicitação em segundos.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: ClientTimeoutPerRequestInSeconds
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ConcurrentTaskCount
A quantidade total de tarefas assíncronas simultâneas.
O valor predefinido é 10.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Container
Nome do contêiner
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
NamePipeline
Position: 1
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Context
Armazenamento do Azure Context Object
Propriedades dos parâmetros
Tipo: IStorageContext
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: True
Valor do pipeline por nome de propriedade: True
Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ExpiresOn
A política de imutabilidade de blob expira
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-PolicyMode
Imutabilidade de BlobPolicyPolicy Mode
Propriedades dos parâmetros
Tipo: String
Default value: None
Valores aceites: Unlocked, Locked, Mutable
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ServerTimeoutPerRequest
O tempo limite do servidor para cada solicitação em segundos.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: ServerTimeoutPerRequestInSeconds
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: 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 os detalhes em https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations .
Propriedades dos parâmetros
Tipo: String
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas