Set-AzStorageBlobContent

Referensi

Modul:: Az.Storage

Mengunggah file lokal ke blob Azure Storage.

Sintaks

Set-AzStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-Tag <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-StandardBlobTier <String>]
   [-EncryptionScope <String>]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

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

Contoh

Contoh 1: Mengunggah file bernama

Set-AzStorageBlobContent -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

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -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-AzStorageBlobContent mengunggah file ke kontainer bernama ContosoUploads.

Contoh 3: Timpa blob yang ada

Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"

Perintah ini mendapatkan blob bernama Planning2015 dalam kontainer ContosoUploads dengan menggunakan cmdlet Get-AzStorageBlob, 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

Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Perintah ini mendapatkan kontainer yang dimulai dengan string ContosoUpload dengan menggunakan cmdlet Get-AzStorageContainer , 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

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -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: Unggah file ke blob dengan properti blob tertentu, dan atur StandardBlobTier sebagai Cool

$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool

AccountName: storageaccountname, ContainerName: contosouploads

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
index.html           BlockBlob 403116          text/html                      2020-09-22 08:06:53Z Cool                                    False

Perintah ini mengunggah file c:\temp\index.html ke kontainer bernama contosouploads dengan properti blob tertentu, dan mengatur StandardBlobTier sebagai Cool. Perintah ini mendapatkan nilai ContentType yang diatur ke properti blob oleh [System.Web.MimeMapping]::GetMimeMapping() API.

Contoh 7: Mengunggah file ke blob dengan Cakupan Enkripsi

$blob = Set-AzStorageBlobContent  -File "mylocalfile" -Container "mycontainer" -Blob "myblob"  -EncryptionScope "myencryptscope"

$blob.BlobProperties.EncryptionScope

myencryptscope

Perintah ini mengunggah file ke blob dengan Lingkup Enkripsi.

Parameter

-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. 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
Lampirkan

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]
Alias:	ClientTimeoutPerRequestInSeconds
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-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 Azure Storage. Cmdlet ini mengunggah konten ke blob dalam kontainer yang ditentukan parameter ini. Untuk mendapatkan objek CloudBlobContainer , gunakan 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. 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-AzStorageContext. Untuk menggunakan konteks penyimpanan yang dibuat dari Token SAS tanpa izin baca, perlu tambahkan parameter -Force untuk melewati keberadaan blob pemeriksaan.

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

-EncryptionScope

Cakupan enkripsi yang akan digunakan saat membuat permintaan ke blob.

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

-StandardBlobTier

Tingkat Blob Blok, nilai yang valid adalah Panas/Dingin/Arsip/Dingin. Lihat detail di https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

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

-Tag

Tag Blob

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

String

CloudBlobContainer

CloudBlob

IStorageContext

Output

AzureStorageBlob

Bagikan melalui

Set-AzStorageBlobContent

Sintaks

Deskripsi

Contoh

Contoh 1: Mengunggah file bernama

Contoh 2: Unggah semua file di bawah folder saat ini

Contoh 3: Timpa blob yang ada

Contoh 4: Mengunggah file ke kontainer dengan menggunakan alur

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

Contoh 6: Unggah file ke blob dengan properti blob tertentu, dan atur StandardBlobTier sebagai Cool

Contoh 7: Mengunggah file ke blob dengan Cakupan Enkripsi

Parameter

-AsJob

-Blob

-BlobType

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Container

-Context

-DefaultProfile

-EncryptionScope

-File

-Force

-Metadata

-PremiumPageBlobTier

-Properties

-ServerTimeoutPerRequest

-StandardBlobTier

-Tag

-TagCondition

-WhatIf

Input

Output

Sumber Daya Tambahan:

Bagikan melalui

Set-AzStorageBlobContent

Sintaks

Deskripsi

Contoh

Contoh 1: Mengunggah file bernama

Contoh 2: Unggah semua file di bawah folder saat ini

Contoh 3: Timpa blob yang ada

Contoh 4: Mengunggah file ke kontainer dengan menggunakan alur

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

Contoh 6: Unggah file ke blob dengan properti blob tertentu, dan atur StandardBlobTier sebagai Cool

Contoh 7: Mengunggah file ke blob dengan Cakupan Enkripsi

Parameter

-AsJob

-Blob

-BlobType

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Container

-Context

-DefaultProfile

-EncryptionScope

-File

-Force

-Metadata

-PremiumPageBlobTier

-Properties

-ServerTimeoutPerRequest

-StandardBlobTier

-Tag

-TagCondition

-WhatIf

Input

Output

Link Terkait

Sumber Daya Tambahan: