Set-AzStorageBlobContent

  • Başvuru
Modül:
Az.Storage

Yerel bir dosyayı Azure Depolama blob'larına yükler.

Syntax

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Blob

Blobun adını belirtir. Bu cmdlet, bu parametrenin belirttiği bir dosyayı Azure Depolama blob'a yükler.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Accepted values:Block, Page, Append
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

CloudBlob nesnesini belirtir. CloudBlob nesnesi almak için Get-Az Depolama Blob cmdlet'ini kullanın.

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:CloudBlobContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Kapsayıcının adını belirtir. Bu cmdlet, bu parametrenin belirttiği kapsayıcıdaki bir bloba bir dosya yükler.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionScope

Bloba istekte bulunurken kullanılacak şifreleme kapsamı.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

Blob içeriği olarak karşıya yüklenecek dosyanın yerel dosya yolunu belirtir.

Type:String
Aliases:FullName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Bu cmdlet'in sizden onay istemeden var olan bir blobun üzerine yazdığını gösterir.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Metadata

Karşıya yüklenen blob için meta verileri belirtir.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PremiumPageBlobTier

Sayfa Blobu Katmanı

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

Karşıya yüklenen blob için özellikleri belirtir. Desteklenen özellikler şunlardır: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Blob Etiketleri

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

String

CloudBlobContainer

CloudBlob

IStorageContext

Çıkışlar

AzureStorageBlob