Set-AzStorageBlobContent
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 P10Perintah 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 FalsePerintah 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
myencryptscopePerintah ini mengunggah file ke blob dengan Lingkup Enkripsi.
Parameter
-AsJob
Jalankan cmdlet di latar belakang.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Blob
Menentukan nama blob. Cmdlet ini mengunggah file ke blob Azure Storage yang ditentukan parameter ini.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | 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
- Lampirkan
Nilai defaultnya adalah Blokir.
| Type: | String |
| Accepted values: | Block, Page, Append |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | Nullable<T>[Int32] |
| Aliases: | ClientTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CloudBlob
Menentukan objek CloudBlob. Untuk mendapatkan objek CloudBlob , gunakan cmdlet Get-AzStorageBlob.
| Type: | CloudBlob |
| Aliases: | ICloudBlob |
| Position: | Named |
| Default value: | None |
| Required: | 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-AzStorageContainer.
| Type: | CloudBlobContainer |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | 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.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | IStorageContext |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EncryptionScope
Cakupan enkripsi yang akan digunakan saat membuat permintaan ke blob.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-File
Menentukan jalur file lokal untuk file yang akan diunggah sebagai konten blob.
| Type: | String |
| Aliases: | FullName |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Menunjukkan bahwa cmdlet ini menimpa blob yang ada tanpa meminta konfirmasi kepada Anda.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metadata
Menentukan metadata untuk blob yang diunggah.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PremiumPageBlobTier
Tingkat Blob Halaman
| Type: | PremiumPageBlobTier |
| Accepted values: | Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80 |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | Nullable<T>[Int32] |
| Aliases: | ServerTimeoutPerRequestInSeconds |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Tag Blob
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
Output
Link Terkait
Azure PowerShell
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk