Get-AzureStorageBlob
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-AzureStorageBlob elenca i 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-AzureStorageBlob 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.
Tipo: | String |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
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] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
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 |
-Container
Specifica il nome del contenitore.
Tipo: | String |
Alias: | N, Name |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Context
Specifica l'account di archiviazione di Azure da cui si vuole ottenere un elenco di BLOB. È possibile usare il cmdlet New-AzureStorageContext per creare un contesto di archiviazione.
Tipo: | IStorageContext |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | 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.
Tipo: | BlobContinuationToken |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
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 |
-IncludeDeleted
Includi BLOB eliminato. Per impostazione predefinita, il BLOB get non includerà il BLOB eliminato.
Tipo: | SwitchParameter |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-MaxCount
Specifica il numero massimo di oggetti restituiti dal cmdlet.
Tipo: | Nullable<T>[Int32] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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".
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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.
Tipo: | Nullable<T>[Int32] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |