Set-AzStorageBlobContent
Yerel bir dosyayı Azure Depolama blob'larına yükler.
Sözdizimi
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>]
Description
Set-Az Depolama BlobContent cmdlet'i yerel bir dosyayı Azure Depolama blob'a yükler.
Örnekler
Örnek 1: Adlandırılmış bir dosyayı karşıya yükleme
Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"
Bu komut, PlanningData adlı dosyayı Planning2015 adlı bir bloba yükler.
Örnek 2: Geçerli klasörün altındaki tüm dosyaları karşıya yükleme
Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"
Bu komut, geçerli klasördeki ve alt klasörlerdeki tüm dosyaları almak için Get-ChildItem çekirdek Windows PowerShell cmdlet'ini kullanır ve ardından işlem hattı işlecini kullanarak bunları geçerli cmdlet'e geçirir. Set-Az Depolama BlobContent cmdlet'i dosyaları ContosoUploads adlı kapsayıcıya yükler.
Örnek 3: Mevcut blobun üzerine yazma
Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"
Bu komut, Get-Az Depolama Blob cmdlet'ini kullanarak ContosoUploads kapsayıcısında Planning2015 adlı blobu alır ve ardından bu blobu geçerli cmdlet'e geçirir. Komut, ContosoPlanning adlı dosyayı Planning2015 olarak karşıya yükler. Bu komut Force parametresini belirtmez. Komut sizden onay ister. Komutu onaylarsanız, cmdlet var olan blobun üzerine yazar.
Örnek 4: İşlem hattını kullanarak kapsayıcıya dosya yükleme
Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"
Bu komut, Get-Az Depolama Container cmdlet'ini kullanarak ContosoUpload dizesiyle başlayan kapsayıcıyı alır ve ardından bu blobu geçerli cmdlet'e geçirir. Komut, ContosoPlanning adlı dosyayı Planning2015 olarak karşıya yükler.
Örnek 5: Meta verileri ve PremiumPageBlobTier'ı P10 olarak içeren bir dosyayı sayfa blob'una yükleme
$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10
İlk komut, blob için meta verileri içeren bir karma tablo oluşturur ve bu karma tabloyu $Metadata değişkeninde depolar. İkinci komut ContosoPlanning adlı dosyayı ContosoUploads adlı kapsayıcıya yükler. Blob, $Metadata'de depolanan meta verileri içerir ve P10 olarak PremiumPageBlobTier'a sahiptir.
Örnek 6: Belirtilen blob özelliklerine sahip bir dosyayı bloba yükleme ve StandardBlobTier'ı Seyrek Erişimli olarak ayarlama
$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
Bu komut c:\temp\index.html dosyasını belirtilen blob özelliklerine sahip contosouploads adlı kapsayıcıya yükler ve StandardBlobTier'ı Seyrek Erişimli olarak ayarlar. Bu komut, [System.Web.MimeMapping]::GetMimeMapping() API'sine göre Blob özelliklerine ayarlanmış ContentType değerini alır.
Örnek 7: Şifreleme Kapsamına sahip bir bloba dosya yükleme
$blob = Set-AzStorageBlobContent -File "mylocalfile" -Container "mycontainer" -Blob "myblob" -EncryptionScope "myencryptscope"
$blob.BlobProperties.EncryptionScope
myencryptscope
Bu komut, şifreleme kapsamına sahip bir bloba dosya yükler.
Parametreler
-AsJob
Cmdlet'i arka planda çalıştırın.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Blob
Blobun adını belirtir. Bu cmdlet, bu parametrenin belirttiği bir dosyayı Azure Depolama blob'a yükler.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-BlobType
Bu cmdlet'in karşıya yüklediği blob türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
- Blok
- Sayfa
- Arkasına Ekle
Varsayılan değer Engelle'dir.
Tür: | String |
Kabul edilen değerler: | Block, Page, Append |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ClientTimeoutPerRequest
Bir hizmet isteği için istemci tarafı zaman aşımı aralığını saniye cinsinden belirtir. Önceki çağrı belirtilen aralıkta başarısız olursa, bu cmdlet isteği yeniden dener. Bu cmdlet, aralık tamamlanmadan başarılı bir yanıt almazsa, bu cmdlet bir hata döndürür.
Tür: | Nullable<T>[Int32] |
Diğer adlar: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-CloudBlob
CloudBlob nesnesini belirtir. CloudBlob nesnesi almak için Get-Az Depolama Blob cmdlet'ini kullanın.
Tür: | CloudBlob |
Diğer adlar: | ICloudBlob |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-CloudBlobContainer
Azure Depolama İstemci kitaplığından bir CloudBlobContainer nesnesi belirtir. Bu cmdlet, bu parametrenin belirttiği kapsayıcıdaki bir bloba içerik yükler. CloudBlobContainer nesnesi edinmek için Get-Az Depolama Container cmdlet'ini kullanın.
Tür: | CloudBlobContainer |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-ConcurrentTaskCount
En fazla eşzamanlı ağ çağrısını belirtir. Eşzamanlı ağ çağrılarının maksimum sayısını belirterek yerel CPU ve bant genişliği kullanımını kısıtlamak için eşzamanlılığı sınırlamak için bu parametreyi kullanabilirsiniz. Belirtilen değer mutlak bir sayıdır ve çekirdek sayısıyla çarpılmaz. Bu parametre, saniyede 100 kilobit gibi düşük bant genişliğine bağlı ortamlardaki ağ bağlantısı sorunlarını azaltmaya yardımcı olabilir. Varsayılan değer 10'dur.
Tür: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Diğer adlar: | cf |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Container
Kapsayıcının adını belirtir. Bu cmdlet, bu parametrenin belirttiği kapsayıcıdaki bir bloba bir dosya yükler.
Tür: | String |
Position: | 1 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Context
Azure depolama bağlamı belirtir. Depolama bağlamı elde etmek için New-Az Depolama Context cmdlet'ini kullanın. Okuma izni olmadan SAS Belirtecinden oluşturulan depolama bağlamını kullanmak için blob varlığını denetlemeyi atlamak için -Force parametresini eklemeniz gerekir.
Tür: | IStorageContext |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Tür: | IAzureContextContainer |
Diğer adlar: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-EncryptionScope
Bloba istekte bulunurken kullanılacak şifreleme kapsamı.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-File
Blob içeriği olarak karşıya yüklenecek dosyanın yerel dosya yolunu belirtir.
Tür: | String |
Diğer adlar: | FullName |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-Force
Bu cmdlet'in sizden onay istemeden var olan bir blobun üzerine yazdığını gösterir.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Metadata
Karşıya yüklenen blob için meta verileri belirtir.
Tür: | Hashtable |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PremiumPageBlobTier
Sayfa Blobu Katmanı
Tür: | PremiumPageBlobTier |
Kabul edilen değerler: | Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Properties
Karşıya yüklenen blob için özellikleri belirtir. Desteklenen özellikler şunlardır: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.
Tür: | Hashtable |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ServerTimeoutPerRequest
İstek için hizmet tarafı zaman aşımı aralığını saniye cinsinden belirtir. Belirtilen aralık hizmetin isteği işlemeden önce geçmesi durumunda depolama hizmeti bir hata döndürür.
Tür: | Nullable<T>[Int32] |
Diğer adlar: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-StandardBlobTier
Blok Blobu Katmanı, geçerli değerler Sık Erişimli/Seyrek Erişimli/Arşiv/Soğuk değerlerdir. Ayrıntılı bilgi için bkz. https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Tag
Blob Etiketleri
Tür: | Hashtable |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TagCondition
Eşleştirme koşulunu denetlemek için isteğe bağlı Etiket ifadesi deyimi. Blob etiketleri verilen ifadeyle eşleşmediğinde blob isteği başarısız olur. https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations sayfasındaki ayrıntılara bakın.
Tür: | String |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-WhatIf
Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Tür: | SwitchParameter |
Diğer adlar: | wi |
Position: | Named |
Default value: | False |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |