Get-AzureStorageBlob

  • Riferimento
Modulo:
Azure.Storage

Elenca i BLOB di un contenitore.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Get-AzureStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-Azure Archiviazione Blob elenca il BLOB nel contenitore specificato in un account di archiviazione di Azure.

Esempio

Esempio 1: Ottenere un BLOB in base al nome del BLOB

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

Questo comando usa un nome BLOB e un carattere jolly per ottenere un BLOB.

Esempio 2: Ottenere BLOB in un contenitore usando la pipeline

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob -IncludeDeleted

   Container Uri: https://storageaccountname.blob.core.windows.net/container1

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime         IsDeleted 
----                 --------  ------          -----------                    ------------         ---------- ------------         --------- 
test1                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:19Z            2017-11-08 08:19:32Z True      
test1                BlockBlob 403116          application/octet-stream       2017-11-08 09:00:29Z                                 True      
test2                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:00Z                                 False

Questo comando usa la pipeline per ottenere tutti i BLOB (inclusi i BLOB nello stato eliminato) in un contenitore.

Esempio 3: Ottenere BLOB in base al prefisso del nome

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Prefix "blob"

Questo comando usa un prefisso del nome per ottenere i BLOB.

Esempio 4: Elencare i BLOB in più batch

PS C:\>$MaxReturn = 10000
PS C:\> $ContainerName = "abc"
PS C:\> $Total = 0
PS C:\> $Token = $Null
PS C:\> do
 {
     $Blobs = Get-AzureStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($Token -ne $Null)
PS C:\> Echo "Total $Total blobs in container $ContainerName"

Questo esempio usa i parametri MaxCount e ContinuationToken per elencare Archiviazione di Azure BLOB in più batch. I primi quattro comandi assegnano valori alle variabili da usare nell'esempio. Il quinto comando specifica un'istruzione Do-While che usa il cmdlet Get-Azure Archiviazione Blob per ottenere i BLOB. L'istruzione include il token di continuazione archiviato nella variabile $Token. $Token cambia valore durante l'esecuzione del ciclo. Per ulteriori informazioni, digitare Get-Help About_Do. Il comando finale usa il comando Echo per visualizzare il totale.

Parametri

-Blob

Specifica un nome o un modello di nome, che può essere usato per una ricerca con caratteri jolly. Se non viene specificato alcun nome BLOB, il cmdlet elenca tutti i BLOB nel contenitore specificato. Se per questo parametro viene specificato un valore, il cmdlet elenca tutti i BLOB con nomi corrispondenti a questo parametro.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Specifica il nome del contenitore.

Type:String
Aliases:N, Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Context

Specifica l'account di archiviazione di Azure da cui si vuole ottenere un elenco di BLOB. È possibile usare il cmdlet New-Azure Archiviazione Context per creare un contesto di archiviazione.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Specifica un token di continuazione per l'elenco di BLOB. Usare questo parametro e il parametro MaxCount per elencare i BLOB in più batch.

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

Includi BLOB eliminato. Per impostazione predefinita, il BLOB get non includerà il BLOB eliminato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

Specifica il numero massimo di oggetti restituiti dal cmdlet.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prefix

Specifica un prefisso per i nomi di BLOB che si desidera ottenere. Questo parametro non supporta l'uso di espressioni regolari o caratteri jolly per la ricerca. Ciò significa che se il contenitore ha solo BLOB denominati "My", "MyBlob1" e "MyBlob2" e si specifica "-Prefix My*", il cmdlet non restituisce BLOB. Tuttavia, se si specifica "-Prefix My", il cmdlet restituisce "My", "My", "MyBlob1" e "MyBlob2".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Specifica l'intervallo di timeout sul lato servizio, espresso in secondi, per una richiesta. Se l'intervallo specificato è trascorso prima che il servizio elabori la richiesta, il servizio di archiviazione restituisce un errore.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

IStorageContext

Output

AzureStorageBlob