Bagikan melalui


Get-AzStorageBlobContent

Mengunduh blob penyimpanan.

Sintaks

Get-AzStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzStorageBlobContent mengunduh blob penyimpanan yang ditentukan. Jika nama blob tidak valid untuk komputer lokal, cmdlet ini secara otomatis menyelesaikannya jika memungkinkan.

Contoh

Contoh 1: Mengunduh konten blob berdasarkan nama

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Perintah ini mengunduh blob berdasarkan nama.

Contoh 2: Mengunduh konten blob menggunakan alur

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

Perintah ini menggunakan alur untuk menemukan dan mengunduh konten blob.

Contoh 3: Mengunduh konten blob menggunakan alur dan karakter kartubebas

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

Contoh ini menggunakan karakter kartubebas tanda bintang dan alur untuk menemukan dan mengunduh konten blob.

Contoh 4: Dapatkan objek blob dan simpan dalam variabel, lalu unduh konten blob dengan objek blob

$blob = Get-AzStorageBlob -Container containername -Blob blobname 
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

Contoh ini pertama-tama mendapatkan objek blob dan menyimpannya dalam variabel, lalu mengunduh konten blob dengan objek blob.

Contoh 5: Mengunduh konten blob dengan Uri blob

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

Contoh ini akan mengunduh konten blob dengan Uri, Uri dapat menjadi Uri dengan token Sas. Jika blob berada di akun disk terkelola, dan server memerlukan token pembawa selain Sas Uri untuk diunduh, cmdlet akan mencoba menghasilkan token pembawa dengan audiens yang dikembalikan server dan info masuk pengguna AAD, lalu mengunduh blob dengan Sas Uri dan token pembawa.

Parameter

-AbsoluteUri

Uri blob untuk diunduh.

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

-AsJob

Jalankan cmdlet di latar belakang.

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

-Blob

Menentukan nama blob yang akan diunduh.

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

-BlobBaseClient

Objek BlobBaseClient

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

-CheckMd5

Menentukan apakah akan memeriksa jumlah Md5 untuk file yang diunduh.

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

-CloudBlob

Menentukan blob cloud. Untuk mendapatkan objek CloudBlob , gunakan cmdlet Get-AzStorageBlob.

Jenis:CloudBlob
Alias:ICloudBlob
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-CloudBlobContainer

Menentukan objek CloudBlobContainer dari pustaka klien penyimpanan Azure. Anda dapat membuatnya atau menggunakan cmdlet Get-AzStorageContainer.

Jenis:CloudBlobContainer
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Container

Menentukan nama kontainer yang memiliki blob yang ingin Anda unduh.

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

-Context

Menentukan akun penyimpanan Azure tempat Anda ingin mengunduh konten 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

-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

-Destination

Menentukan lokasi untuk menyimpan file yang diunduh.

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

-Force

Menimpa file yang ada tanpa konfirmasi.

Jenis:SwitchParameter
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

-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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

CloudBlob

CloudBlobContainer

IStorageContext

Output

AzureStorageBlob

Catatan

  • Jika nama blob tidak valid untuk komputer lokal, cmdlet ini akan menyelesaikannya secara otomatis, jika memungkinkan.