Compartilhar via

Remove-AzStorageBlob

  • Referência
Módulo:
Az.Storage

Remove o blob de armazenamento especificado.

Sintaxe

Remove-AzStorageBlob
      [-Blob] <String>
      [-Container] <String>
      [-DeleteSnapshot]
      [-SnapshotTime <DateTimeOffset>]
      [-VersionId <String>]
      [-Force]
      [-PassThru]
      [-TagCondition <String>]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageBlob
      -CloudBlob <CloudBlob>
      [-BlobBaseClient <BlobBaseClient>]
      [-DeleteSnapshot]
      [-Force]
      [-PassThru]
      [-TagCondition <String>]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzStorageBlob
      -CloudBlobContainer <CloudBlobContainer>
      [-Blob] <String>
      [-DeleteSnapshot]
      [-SnapshotTime <DateTimeOffset>]
      [-VersionId <String>]
      [-Force]
      [-PassThru]
      [-TagCondition <String>]
      [-Context <IStorageContext>]
      [-ServerTimeoutPerRequest <Int32>]
      [-ClientTimeoutPerRequest <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-ConcurrentTaskCount <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Remove-AzStorageBlob remove o blob especificado de uma conta de armazenamento no Azure.

Exemplos

Exemplo 1: remover um blob de armazenamento pelo nome

Remove-AzStorageBlob -Container "ContainerName" -Blob "BlobName"

Esse comando remove um blob identificado pelo nome.

Exemplo 2: remover um blob de armazenamento usando o pipeline

Get-AzStorageBlob -Container "ContainerName" -Blob "BlobName" | Remove-AzStorageBlob

Esse comando usa o pipeline.

Exemplo 3: remover blobs de armazenamento usando o pipeline

Get-AzStorageContainer -Container container* | Remove-AzStorageBlob -Blob "BlobName"

Esse comando usa o caractere curinga do asterisco (*) e o pipeline para recuperar o blob ou blobs e os remove.

Exemplo 4: remover uma única versão de blob

Remove-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

Esse comando remove um único verion de blobs com VersionId.

Exemplo 5: remover um único instantâneo de blob

Remove-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

Esse comando remove um único instantâneo de blobs com SnapshotTime.

Parâmetros

-Blob

Especifica o nome do blob que você deseja remover.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BlobBaseClient

Objeto BlobBaseClient

Tipo:BlobBaseClient
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ClientTimeoutPerRequest

Especifica o intervalo de tempo limite do lado do cliente, em segundos, para uma solicitação de serviço. Se a chamada anterior falhar no intervalo especificado, esse cmdlet repetirá a solicitação. Se esse cmdlet não receber uma resposta bem-sucedida antes que o intervalo se esgote, esse cmdlet retornará um erro.

Tipo:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CloudBlob

Especifica um blob de nuvem. Para obter um objeto CloudBlob, use o cmdlet Get-AzStorageBlob.

Tipo:CloudBlob
Aliases:ICloudBlob
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CloudBlobContainer

Especifica um objeto CloudBlobContainer da biblioteca do Cliente de Armazenamento do Azure. Você pode usar o cmdlet Get-AzStorageContainer para obtê-lo.

Tipo:CloudBlobContainer
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConcurrentTaskCount

Especifica o máximo de chamadas de rede simultâneas. Você pode usar esse parâmetro para limitar a simultaneidade para limitar o uso local de CPU e largura de banda especificando o número máximo de chamadas de rede simultâneas. O valor especificado é uma contagem absoluta e não é multiplicado pela contagem de núcleos. Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 quilobits por segundo. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Container

Especifica o nome do contêiner.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Context

Especifica o contexto de armazenamento do Azure. Você pode usar o cmdlet New-AzStorageContext para criá-lo.

Tipo:IStorageContext
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeleteSnapshot

Especifica que todos os instantâneos sejam excluídos, mas não o blob base. Se esse parâmetro não for especificado, o blob base e seus instantâneos serão excluídos juntos. O usuário é solicitado a confirmar a operação de exclusão.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

Indica que esse cmdlet remove o blob e seu instantâneo sem confirmação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Indica que esse cmdlet retorna um booliano que reflete o sucesso da operação. Por padrão, esse cmdlet não retorna um valor.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServerTimeoutPerRequest

Especifica o perfil do Azure para o cmdlet a ser lido. Se não for especificado, o cmdlet lerá do perfil padrão.

Tipo:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SnapshotTime

Blob SnapshotTime

Tipo:Nullable<T>[DateTimeOffset]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TagCondition

Instrução de expressão de marca opcional para verificar a condição de correspondência. A solicitação de blob falhará quando as marcas 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VersionId

Blob VersionId

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

CloudBlob

CloudBlobContainer

IStorageContext

Saídas

Boolean