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 |
Terima input alur: | False |
Terima karakter wildcard: | 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 |
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 |
-CloudBlob
Menentukan objek CloudBlob. Untuk mendapatkan objek CloudBlob , gunakan cmdlet Get-AzureStorageBlob.
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 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 |
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. Cmdlet ini mengunggah file ke blob dalam kontainer yang ditentukan parameter ini.
Jenis: | String |
Position: | 1 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | False |
Terima karakter wildcard: | 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 |
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 |
-File
Menentukan jalur file lokal untuk file yang akan diunggah sebagai konten blob.
Jenis: | String |
Alias: | FullName |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-Force
Menunjukkan bahwa cmdlet ini menimpa blob yang ada tanpa meminta konfirmasi kepada Anda.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Metadata
Menentukan metadata untuk blob yang diunggah.
Jenis: | Hashtable |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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 |
Terima input alur: | False |
Terima karakter wildcard: | 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 |
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 |
-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 |