Condividi tramite

Remove-AzStorageBlob

  • Riferimento
Modulo:
Az.Storage

Rimuove il BLOB di archiviazione specificato.

Sintassi

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>]

Descrizione

Il cmdlet Remove-Az Archiviazione Blob rimuove il BLOB specificato da un account di archiviazione in Azure.

Esempio

Esempio 1: Rimuovere un BLOB di archiviazione in base al nome

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

Questo comando rimuove un BLOB identificato dal nome.

Esempio 2: Rimuovere un BLOB di archiviazione usando la pipeline

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

Questo comando usa la pipeline.

Esempio 3: Rimuovere i BLOB di archiviazione usando la pipeline

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

Questo comando usa il carattere jolly asterisco (*) e la pipeline per recuperare il BLOB o i BLOB e quindi li rimuove.

Esempio 4: Rimuovere una singola versione del BLOB

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

Questo comando rimuove un singolo BLOB con VersionId.

Esempio 5: Rimuovere un singolo snapshot BLOB

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

Questo comando rimuove un singolo snapshot di BLOB con SnapshotTime.

Parametri

-Blob

Specifica il nome del BLOB da rimuovere.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-BlobBaseClient

Oggetto BlobBaseClient

Tipo:BlobBaseClient
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ClientTimeoutPerRequest

Specifica l'intervallo di timeout lato client, espresso in secondi, per una richiesta di servizio. Se la chiamata precedente ha esito negativo nell'intervallo specificato, questo cmdlet ritenta la richiesta. Se questo cmdlet non riceve una risposta corretta prima della scadenza dell'intervallo, questo cmdlet restituisce un errore.

Tipo:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CloudBlob

Specifica un BLOB cloud. Per ottenere un oggetto CloudBlob, usare il cmdlet Get-Az Archiviazione Blob.

Tipo:CloudBlob
Alias:ICloudBlob
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-CloudBlobContainer

Specifica un oggetto CloudBlobContainer dalla libreria client Archiviazione di Azure. È possibile usare il cmdlet Get-Az Archiviazione Container per ottenerlo.

Tipo:CloudBlobContainer
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ConcurrentTaskCount

Specifica il numero massimo di chiamate di rete simultanee. È possibile usare questo parametro per limitare la concorrenza per limitare l'utilizzo della CPU e della larghezza di banda locali specificando il numero massimo di chiamate di rete simultanee. Il valore specificato è un conteggio assoluto e non viene moltiplicato per il numero di core. Questo parametro consente di ridurre i problemi di connessione di rete in ambienti a larghezza di banda ridotta, ad esempio 100 kilobit al secondo. Il valore predefinito è 10.

Tipo:Nullable<T>[Int32]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Container

Specifica il nome del contenitore.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Context

Specifica il contesto di archiviazione di Azure. È possibile usare il cmdlet New-Az Archiviazione Context per crearlo.

Tipo:IStorageContext
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeleteSnapshot

Specifica che tutti gli snapshot devono essere eliminati, ma non il BLOB di base. Se questo parametro non viene specificato, il BLOB di base e i relativi snapshot vengono eliminati insieme. All'utente viene richiesto di confermare l'operazione di eliminazione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che questo cmdlet rimuove il BLOB e il relativo snapshot senza confermare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Indica che questo cmdlet restituisce un valore booleano che riflette l'esito positivo dell'operazione. Per impostazione predefinita, questo cmdlet non restituisce un valore.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServerTimeoutPerRequest

Specifica il profilo di Azure per il cmdlet da leggere. Se non specificato, il cmdlet legge dal profilo predefinito.

Tipo:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SnapshotTime

Blob SnapshotTime

Tipo:Nullable<T>[DateTimeOffset]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TagCondition

Istruzione di espressione tag facoltativa per controllare la condizione di corrispondenza. La richiesta BLOB avrà esito negativo quando i tag BLOB non corrispondono all'espressione specificata. Vedere i dettagli in https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VersionId

ID versione BLOB

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

CloudBlob

CloudBlobContainer

IStorageContext

Output

Boolean