Bagikan melalui

Get-AzureStorageBlob

  • Referensi
Modul:
Azure.Storage

Mencantumkan blob dalam kontainer.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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

Deskripsi

Cmdlet Get-AzureStorageBlob mencantumkan blob dalam kontainer yang ditentukan di akun penyimpanan Azure.

Contoh

Contoh 1: Dapatkan blob menurut nama blob

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

Perintah ini menggunakan nama blob dan kartubebas untuk mendapatkan blob.

Contoh 2: Mendapatkan blob dalam kontainer dengan menggunakan alur

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

Perintah ini menggunakan alur untuk mendapatkan semua blob (menyertakan blob dalam status Dihapus) dalam kontainer.

Contoh 3: Mendapatkan blob berdasarkan awalan nama

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

Perintah ini menggunakan awalan nama untuk mendapatkan blob.

Contoh 4: Mencantumkan blob dalam beberapa 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"

Contoh ini menggunakan parameter MaxCount dan ContinuationToken untuk mencantumkan blob Azure Storage dalam beberapa batch. Empat perintah pertama menetapkan nilai ke variabel untuk digunakan dalam contoh. Perintah kelima menentukan pernyataan Do-While yang menggunakan cmdlet Get-AzureStorageBlob untuk mendapatkan blob. Pernyataan ini mencakup token kelanjutan yang disimpan dalam variabel $Token. $Token mengubah nilai saat perulangan berjalan. Untuk informasi selengkapnya, ketik Get-Help About_Do. Perintah akhir menggunakan perintah Echo untuk menampilkan total.

Parameter

-Blob

Menentukan pola nama atau nama, yang dapat digunakan untuk pencarian kartubebas. Jika tidak ada nama blob yang ditentukan, cmdlet mencantumkan semua blob dalam kontainer yang ditentukan. Jika nilai ditentukan untuk parameter ini, cmdlet mencantumkan semua blob dengan nama yang cocok dengan parameter ini.

Jenis:String
Position:0
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ClientTimeoutPerRequest

Menentukan interval waktu habis sisi klien, dalam hitungan detik, untuk satu permintaan layanan. Jika panggilan sebelumnya gagal dalam interval yang ditentukan, cmdlet ini akan mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ConcurrentTaskCount

Menentukan panggilan jaringan bersamaan maksimum. Anda dapat menggunakan parameter ini untuk membatasi konkurensi untuk membatasi penggunaan CPU dan bandwidth lokal dengan menentukan jumlah maksimum panggilan jaringan bersamaan. Nilai yang ditentukan adalah jumlah absolut dan tidak dikalikan dengan jumlah inti. Parameter ini dapat membantu mengurangi masalah koneksi jaringan di lingkungan bandwidth rendah, seperti 100 kilobit per detik. Nilai defaultnya adalah 10.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Container

Menentukan nama kontainer.

Jenis:String
Alias:N, Name
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Context

Menentukan akun penyimpanan Azure tempat Anda ingin mendapatkan daftar blob. Anda dapat menggunakan cmdlet New-AzureStorageContext untuk membuat konteks penyimpanan.

Jenis:IStorageContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ContinuationToken

Menentukan token kelanjutan untuk daftar blob. Gunakan parameter ini dan parameter MaxCount untuk mencantumkan blob dalam beberapa batch.

Jenis:BlobContinuationToken
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IncludeDeleted

Sertakan Blob yang Dihapus, secara default dapatkan blob tidak akan menyertakan blob yang dihapus.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-MaxCount

Menentukan jumlah maksimum objek yang dikembalikan cmdlet ini.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Prefix

Menentukan awalan untuk nama blob yang ingin Anda dapatkan. Parameter ini tidak mendukung penggunaan ekspresi reguler atau karakter kartubebas untuk dicari. Ini berarti bahwa jika kontainer hanya memiliki blob bernama "My", "MyBlob1", dan "MyBlob2" dan Anda menentukan "-Prefix My*", cmdlet tidak mengembalikan blob. Namun, jika Anda menentukan "-Prefix My", cmdlet mengembalikan "My", "MyBlob1", dan "MyBlob2".

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServerTimeoutPerRequest

Menentukan interval waktu habis sisi layanan, dalam hitungan detik, untuk permintaan. Jika interval yang ditentukan berlalu sebelum layanan memproses permintaan, layanan penyimpanan mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

IStorageContext

Output

AzureStorageBlob