Get-AzStorageBlob
Mencantumkan blob dalam kontainer.
Sintaks
BlobName (Default)
Get-AzStorageBlob
[[-Blob] <String>]
[-Container] <String>
[-IncludeDeleted]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
SingleBlobSnapshotTime
Get-AzStorageBlob
[-Blob] <String>
[-Container] <String>
-SnapshotTime <DateTimeOffset>
[-IncludeDeleted]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
SingleBlobVersionID
Get-AzStorageBlob
[-Blob] <String>
[-Container] <String>
-VersionId <String>
[-IncludeDeleted]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
BlobPrefix
Get-AzStorageBlob
[-Container] <String>
[-Prefix <String>]
[-IncludeDeleted]
[-IncludeVersion]
[-IncludeTag]
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Deskripsi
Cmdlet Get-AzStorageBlob mencantumkan blob dalam kontainer yang ditentukan di akun penyimpanan Azure.
Contoh
Get-AzStorageBlob -Container "ContainerName" -Blob blob*
Perintah ini menggunakan nama blob dan kartubebas untuk mendapatkan blob.
Contoh 2: Mendapatkan blob dalam kontainer dengan menggunakan alur
Get-AzStorageContainer -Name container* | Get-AzStorageBlob -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
Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"
Perintah ini menggunakan awalan nama untuk mendapatkan blob.
Contoh 4: Mencantumkan blob dalam beberapa batch
$MaxReturn = 10000
$ContainerName = "abc"
$Total = 0
$Token = $Null
do
{
$Blobs = Get-AzStorageBlob -Container $ContainerName -MaxCount $MaxReturn -ContinuationToken $Token
$Total += $Blobs.Count
if($Blobs.Length -le 0) { Break;}
$Token = $Blobs[$blobs.Count -1].ContinuationToken;
}
While ($null -ne $Token)
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-AzStorageBlob 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.
Contoh 5: Mendapatkan semua blob dalam kontainer termasuk versi blob
Get-AzStorageBlob -Container "containername" -IncludeVersion
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot False 2020-07-06T06:56:06.2432658Z
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot 2020-07-06T06:56:06.8588431Z False
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot False 2020-07-06T06:56:06.8598431Z *
blob2 BlockBlob 2097152 application/octet-stream 2020-07-03 16:19:16Z Hot False 2020-07-03T16:19:16.2883167Z
blob2 BlockBlob 2097152 application/octet-stream 2020-07-03 16:19:35Z Hot False 2020-07-03T16:19:35.2381110Z *
Perintah ini mendapatkan semua blob dalam kontainer termasuk versi blob.
Contoh 6: Mendapatkan satu versi blob
Get-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
blob2 BlockBlob 2097152 application/octet-stream 2020-07-03 16:19:16Z Hot False 2020-07-03T16:19:16.2883167Z
Perintah ini mendapatkan versi blob tunggal dengan VersionId.
Contoh 7: Mendapatkan satu rekam jepret blob
Get-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
blob1 BlockBlob 2097152 application/octet-stream 2020-07-06 06:56:06Z Hot 2020-07-06T06:56:06.8588431Z False
Perintah ini mendapatkan satu rekam jepret blob dengan SnapshotTime.
Contoh 8: Dapatkan blob menyertakan tag blob
$blobs = Get-AzStorageBlob -Container "containername" -IncludeTag
$blobs
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob BlockBlob 2097152 application/octet-stream 2020-07-23 09:35:02Z Hot False 2020-07-23T09:35:02.8527357Z *
testblob2 BlockBlob 2097152 application/octet-stream 2020-07-23 09:35:04Z Hot False 2020-07-23T09:35:04.0856187Z *
$blobs[0].Tags
Name Value
---- -----
tag1 value1
tag2 value2
Perintah ini mencantumkan blob dari kontainer dengan tag blob, dan menampilkan tag blob pertama.
Contoh 9: Dapatkan satu blob dengan kondisi tag blob
Get-AzStorageBlob -Container "containername" -Blob testblob -TagCondition """tag1""='value1'"
AccountName: storageaccountname, ContainerName: containername
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
testblob BlockBlob 2097152 application/octet-stream 2020-07-23 09:35:02Z Hot False 2020-07-23T09:35:02.8527357Z *
Perintah ini mendapatkan satu blob dengan kondisi tag blob.
Cmdlet hanya akan berhasil ketika blob berisi tag dengan nama "tag1" dan nilai "value1", jika tidak cmdlet akan gagal dengan kode kesalahan 412.
Contoh 10: Dapatkan properti blob (misalnya: ImmutabilityPolicy) dari satu blob
$blobProperties = (Get-AzStorageBlob -Container "ContainerName" -Blob "blob" -Context $ctx).BlobProperties
$blobProperties.ImmutabilityPolicy
ExpiresOn PolicyMode
--------- ----------
9/17/2024 2:49:32 AM +00:00 Unlocked
Contoh perintah ini mendapatkan properti kekekalan dari satu blob. Anda bisa mendapatkan daftar terperinci properti blob dari properti BlobProperties , termasuk tetapi tidak terbatas pada: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy, dll... Untuk mencantumkan beberapa blob (jalankan cmdlet tanpa nama blob), gunakan ListBlobProperties.Properties alih-alih BlobProperties untuk performa yang lebih baik.
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. Parameter ini mendukung kartubebas di mana saja dalam string.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: True DontShow: False
Kumpulan parameter
BlobName
Position: 0 Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: Nullable<T> [ Int32 ]
Nilai default: None Mendukung wildcard: False DontShow: False Alias: ClientTimeoutPerRequestInSeconds
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: Nullable<T> [ Int32 ]
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-Container
Menentukan nama kontainer.
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False Alias: N, Nama
Kumpulan parameter
(All)
Position: 1 Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-Context
Menentukan akun penyimpanan Azure tempat Anda ingin mendapatkan daftar blob.
Anda dapat menggunakan cmdlet New-AzStorageContext untuk membuat konteks penyimpanan.
Properti parameter
Jenis: IStorageContext
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: True Nilai dari alur berdasarkan nama properti: True Nilai dari argumen yang tersisa: False
-ContinuationToken
Menentukan token kelanjutan untuk daftar blob.
Gunakan parameter ini dan parameter MaxCount untuk mencantumkan blob dalam beberapa batch.
Properti parameter
Jenis: Microsoft.Azure.Storage.Blob.BlobContinuationToken
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
Properti parameter
Jenis: IAzureContextContainer
Nilai default: None Mendukung wildcard: False DontShow: False Alias: AzureRmContext, AzureCredential
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-IncludeDeleted
Sertakan Blob yang Dihapus, secara default dapatkan blob tidak akan menyertakan blob yang dihapus.
Properti parameter
Jenis: SwitchParameter
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-IncludeTag
Sertakan tag blob, secara default dapatkan blob tidak akan menyertakan tag blob.
Properti parameter
Jenis: SwitchParameter
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-IncludeVersion
Versi blob akan dicantumkan hanya jika parameter ini ada, secara default mendapatkan blob tidak akan menyertakan versi blob.
Properti parameter
Jenis: SwitchParameter
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
BlobPrefix
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-MaxCount
Menentukan jumlah maksimum objek yang dikembalikan cmdlet ini.
Properti parameter
Jenis: Nullable<T> [ Int32 ]
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: 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".
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
BlobPrefix
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: 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.
Properti parameter
Jenis: Nullable<T> [ Int32 ]
Nilai default: None Mendukung wildcard: False DontShow: False Alias: ServerTimeoutPerRequestInSeconds
Kumpulan parameter
(All)
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-SnapshotTime
Blob SnapshotTime
Properti parameter
Kumpulan parameter
SingleBlobSnapshotTime
Position: Named Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-TagCondition
Pernyataan ekspresi Tag opsional untuk memeriksa kondisi kecocokan.
Permintaan blob akan gagal ketika tag blob tidak cocok dengan ekspresi yang diberikan.
Lihat detail di https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations .
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
BlobName
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
SingleBlobSnapshotTime
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
SingleBlobVersionID
Position: Named Wajib: False Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
-VersionId
Blob VersionId
Properti parameter
Jenis: String
Nilai default: None Mendukung wildcard: False DontShow: False
Kumpulan parameter
SingleBlobVersionID
Position: Named Wajib: True Nilai dari alur: False Nilai dari alur berdasarkan nama properti: False Nilai dari argumen yang tersisa: False
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters .
Output
