Bagikan melalui


Set-AzureStorageBlobContent

Mengunggah file lokal ke blob Azure Storage.

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

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzureStorageBlobContent mengunggah file lokal ke blob Azure Storage.

Contoh

Contoh 1: Mengunggah file bernama

PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Perintah ini mengunggah file yang bernama PlanningData ke blob bernama Planning2015.

Contoh 2: Unggah semua file di bawah folder saat ini

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"

Perintah ini menggunakan cmdlet Windows PowerShell inti Get-ChildItem untuk mendapatkan semua file di folder saat ini dan di subfolder, lalu meneruskannya ke cmdlet saat ini dengan menggunakan operator alur. Cmdlet Set-AzureStorageBlobContent mengunggah file ke kontainer bernama ContosoUploads.

Contoh 3: Timpa blob yang ada

PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"

Perintah ini mendapatkan blob bernama Planning2015 dalam kontainer ContosoUploads dengan menggunakan cmdlet Get-AzureStorageBlob, lalu meneruskan blob tersebut ke cmdlet saat ini. Perintah mengunggah file yang bernama ContosoPlanning sebagai Planning2015. Perintah ini tidak menentukan parameter Force . Perintah meminta konfirmasi kepada Anda. Jika Anda mengonfirmasi perintah, cmdlet akan menimpa blob yang ada.

Contoh 4: Mengunggah file ke kontainer dengan menggunakan alur

PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Perintah ini mendapatkan kontainer yang dimulai dengan string ContosoUpload dengan menggunakan cmdlet Get-AzureStorageContainer , lalu meneruskan blob tersebut ke cmdlet saat ini. Perintah mengunggah file yang bernama ContosoPlanning sebagai Planning2015.

Contoh 5: Mengunggah file ke blob halaman dengan metadata dan PremiumPageBlobTier sebagai P10

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

Perintah pertama membuat tabel hash yang berisi metadata untuk blob, dan menyimpan tabel hash dalam variabel $Metadata. Perintah kedua mengunggah file yang diberi nama ContosoPlanning ke kontainer bernama ContosoUploads. Blob mencakup metadata yang disimpan di $Metadata, dan memiliki PremiumPageBlobTier sebagai P10.

Contoh 6: Mengunggah file ke blob dengan properti blob tertentu

PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}

Perintah ini mengunggah file yang diberi nama ContosoPlanning ke kontainer bernama ContosoUploads dengan properti blob tertentu.

Parameter

-Blob

Menentukan nama blob. Cmdlet ini mengunggah file ke blob Azure Storage yang ditentukan parameter ini.

Jenis:String
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-BlobType

Menentukan jenis untuk blob yang diunggah cmdlet ini. Nilai yang dapat diterima untuk parameter ini adalah:

  • Blokir
  • Halaman Nilai defaultnya adalah Blokir.
Jenis:String
nilai yang diterima:Block, Page, Append
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

Menentukan objek CloudBlob. Untuk mendapatkan objek CloudBlob , gunakan cmdlet Get-AzureStorageBlob.

Jenis:CloudBlob
Aliases:ICloudBlob
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

Menentukan objek CloudBlobContainer dari pustaka Klien Azure Storage. Cmdlet ini mengunggah konten ke blob dalam kontainer yang ditentukan parameter ini. Untuk mendapatkan objek CloudBlobContainer , gunakan cmdlet Get-AzureStorageContainer.

Jenis:CloudBlobContainer
Position:Named
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Aliases:cf
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Menentukan nama kontainer. Cmdlet ini mengunggah file ke blob dalam kontainer yang ditentukan parameter ini.

Jenis:String
Position:1
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-Context

Menentukan konteks penyimpanan Azure. Untuk mendapatkan konteks penyimpanan, gunakan cmdlet New-AzureStorageContext. Untuk menggunakan konteks penyimpanan yang dibuat dari Token SAS tanpa izin baca, perlu tambahkan parameter -Force untuk melewati pemeriksaan eksistensi blob.

Jenis:IStorageContext
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Jenis:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Menentukan jalur file lokal untuk file yang akan diunggah sebagai konten blob.

Jenis:String
Aliases:FullName
Position:0
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Menunjukkan bahwa cmdlet ini menimpa blob yang ada tanpa meminta konfirmasi kepada Anda.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Metadata

Menentukan metadata untuk blob yang diunggah.

Jenis:Hashtable
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-PremiumPageBlobTier

Tingkat Blob Halaman

Jenis:PremiumPageBlobTier
nilai yang diterima:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Properties

Menentukan properti untuk blob yang diunggah. Properti yang didukung adalah: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Jenis:Hashtable
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters: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
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Jenis:SwitchParameter
Aliases:wi
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

CloudBlobContainer

CloudBlob

IStorageContext

Output

AzureStorageBlob