Get-AzStorageBlob

Referensi

Modul:: Az.Storage

Mencantumkan blob dalam kontainer.

Sintaks

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

Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -SnapshotTime <DateTimeOffset>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -VersionId <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageBlob
   [-Prefix <String>]
   [-Container] <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

Contoh 1: Dapatkan blob menurut nama blob

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 satu verion blob 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 prTooperties 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.

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

-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]
Alias:	ClientTimeoutPerRequestInSeconds
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-AzStorageContext 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

-IncludeTag

Sertakan tag blob, secara default dapatkan blob tidak akan menyertakan tag blob.

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

-IncludeVersion

Versi blob akan dicantumkan hanya jika parameter ini ada, secara default mendapatkan blob tidak akan menyertakan versi blob.

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]
Alias:	ServerTimeoutPerRequestInSeconds
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-SnapshotTime

Blob SnapshotTime

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

-TagCondition

Pernyataan ekspresi Tag opsional untuk memeriksa kondisi kecocokan. Permintaan blob akan gagal ketika tag blob tidak cocok dengan ekspresi yang diberikan. Lihat detailnya di https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-VersionId

Blob VersionId

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

Input

String

IStorageContext

Output

AzureStorageBlob

Bagikan melalui

Get-AzStorageBlob

Sintaks

Deskripsi

Contoh

Contoh 1: Dapatkan blob menurut nama blob

Contoh 2: Mendapatkan blob dalam kontainer dengan menggunakan alur

Contoh 3: Mendapatkan blob berdasarkan awalan nama

Contoh 4: Mencantumkan blob dalam beberapa batch

Contoh 5: Mendapatkan semua blob dalam kontainer termasuk versi blob

Contoh 6: Mendapatkan satu versi blob

Contoh 7: Mendapatkan satu rekam jepret blob

Contoh 8: Dapatkan blob menyertakan tag blob

Contoh 9: Dapatkan satu blob dengan kondisi tag blob

Contoh 10: Dapatkan properti blob (misalnya: ImmutabilityPolicy) dari satu blob

Parameter

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Input

Output

Sumber Daya Tambahan:

Bagikan melalui

Get-AzStorageBlob

Sintaks

Deskripsi

Contoh

Contoh 1: Dapatkan blob menurut nama blob

Contoh 2: Mendapatkan blob dalam kontainer dengan menggunakan alur

Contoh 3: Mendapatkan blob berdasarkan awalan nama

Contoh 4: Mencantumkan blob dalam beberapa batch

Contoh 5: Mendapatkan semua blob dalam kontainer termasuk versi blob

Contoh 6: Mendapatkan satu versi blob

Contoh 7: Mendapatkan satu rekam jepret blob

Contoh 8: Dapatkan blob menyertakan tag blob

Contoh 9: Dapatkan satu blob dengan kondisi tag blob

Contoh 10: Dapatkan properti blob (misalnya: ImmutabilityPolicy) dari satu blob

Parameter

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Input

Output

Link Terkait

Sumber Daya Tambahan: