Remove-AzStorageBlob
Remove o blob de armazenamento especificado.
Sintaxe
NamePipeline (Padrão)
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>]
BlobPipeline
Remove-AzStorageBlob
-CloudBlob <CloudBlob>
[-BlobBaseClient <BlobBaseClient>]
[-DeleteSnapshot]
[-Force]
[-PassThru]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ContainerPipeline
Remove-AzStorageBlob
[-Blob] <String>
-CloudBlobContainer <CloudBlobContainer>
[-DeleteSnapshot]
[-SnapshotTime <DateTimeOffset>]
[-VersionId <String>]
[-Force]
[-PassThru]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
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"
Este comando remove um blob identificado pelo seu nome.
Exemplo 2: Remover um blob de armazenamento usando o pipeline
Get-AzStorageBlob -Container "ContainerName" -Blob "BlobName" | Remove-AzStorageBlob
Este comando usa o pipeline.
Exemplo 3: Remover blobs de armazenamento usando o pipeline
Get-AzStorageContainer -Container container* | Remove-AzStorageBlob -Blob "BlobName"
Este comando usa o caractere curinga asterisco (*) e o pipeline para recuperar o blob ou blobs e, em seguida, os remove.
Exemplo 4: Remover uma única versão de blob
Remove-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"
Este comando remove uma única versão 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"
Este comando remove um único instantâneo de blobs com SnapshotTime.
Parâmetros
-Blob
Especifica o nome do blob que você deseja remover.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
NamePipeline
Posição: 0
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
ContainerPipeline
Posição: 0
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-BlobBaseClient
Objeto BlobBaseClient
Propriedades dos parâmetros
Tipo: BlobBaseClient
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
BlobPipeline
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: 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 tentará novamente a solicitação.
Se este cmdlet não receber uma resposta bem-sucedida antes do intervalo passar, ele retornará um erro.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: ClientTimeoutPerRequestInSeconds
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-CloudBlob
Especifica um blob de nuvem.
Para obter um objeto CloudBlob , use o cmdlet Get-AzStorageBlob.
Propriedades dos parâmetros
Tipo: Microsoft.Azure.Storage.Blob.CloudBlob
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: ICloudBlob
Conjuntos de parâmetros
BlobPipeline
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-CloudBlobContainer
Especifica um objeto CloudBlobContainer da biblioteca do Cliente de Armazenamento do Azure.
Você pode usar o cmdlet Get-AzStorageContainer para obtê-lo.
Propriedades dos parâmetros
Tipo: Microsoft.Azure.Storage.Blob.CloudBlobContainer
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
ContainerPipeline
Posição: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: 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 da CPU e da 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 principal.
Esse parâmetro pode ajudar a reduzir problemas de conexão de rede em ambientes de baixa largura de banda, como 100 kilobits por segundo.
O valor padrão é 10.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: False
Suporta curingas: False
DontShow: False
Pseudónimos: Cf.
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Container
Especifica o nome do contêiner.
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
NamePipeline
Posição: 1
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Context
Especifica o contexto de armazenamento do Azure.
Você pode usar o cmdlet New-AzStorageContext para criá-lo.
Propriedades dos parâmetros
Tipo: IStorageContext
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: True
Valor do pipeline por nome da propriedade: True
Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: 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.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-Force
Indica que esse cmdlet remove o blob e seu instantâneo sem confirmação.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-PassThru
Indica que esse cmdlet retorna um Boolean que reflete o sucesso da operação.
Por padrão, esse cmdlet não retorna um valor.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-ServerTimeoutPerRequest
Especifica o perfil do Azure para o cmdlet ler.
Se não for especificado, o cmdlet será lido a partir do perfil padrão.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Int32 ]
Valor padrão: None
Suporta curingas: False
DontShow: False
Pseudónimos: ServerTimeoutPerRequestInSeconds
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-SnapshotTime
Blob SnapshotTime
Propriedades dos parâmetros
Conjuntos de parâmetros
NamePipeline
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
ContainerPipeline
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: 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
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-VersionId
Blob VersionId
Propriedades dos parâmetros
Tipo: String
Valor padrão: None
Suporta curingas: False
DontShow: False
Conjuntos de parâmetros
NamePipeline
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
ContainerPipeline
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor padrão: False
Suporta curingas: False
DontShow: False
Pseudónimos: Wi
Conjuntos de parâmetros
(All)
Posição: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome da propriedade: False
Valor dos argumentos restantes: 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 .
Microsoft.Azure.Storage.Blob.CloudBlob
Microsoft.Azure.Storage.Blob.CloudBlobContainer
Saídas