Set-AzStorageBlobContent

Modül:

Az.Storage Module

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

Syntax

SendManual (Varsayılan)

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>]

ContainerPipeline

Set-AzStorageBlobContent
    [-File] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-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>]

BlobPipeline

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-AzStorageBlobContent cmdlet'i yerel bir dosyayı bir Azure Depolama blob'una 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 çekirdek Windows PowerShell cmdlet'ini Get-ChildItem kullanır ve ardından işlem hattı işlecini kullanarak bunları geçerli cmdlet'e geçirir. Set-AzStorageBlobContent 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-AzStorageBlob cmdlet'ini kullanarak ContosoUploads kapsayıcısında Planning2015 adlı blobu alır ve 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-AzStorageContainer 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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Blob

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SendManual

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

ContainerPipeline

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-BlobType

Bu cmdlet'in karşıya yüklediği blob türünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• Block
• Sayfa
• Append

Varsayılan değer Engelle'dir.

Parametre özellikleri

Tür:	String
Default value:	None
Kabul edilen değerler:	Block, Page, Append
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	ClientTimeoutPerRequestInSeconds

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CloudBlob

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

Parametre özellikleri

Tür:	Microsoft.Azure.Storage.Blob.CloudBlob
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	ICloudBlob

Parametre kümeleri

BlobPipeline

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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 almak için Get-AzStorageContainer cmdlet'ini kullanın.

Parametre özellikleri

Tür:	Microsoft.Azure.Storage.Blob.CloudBlobContainer
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ContainerPipeline

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Container

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SendManual

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Context

Azure depolama bağlamı belirtir. Depolama bağlamı elde etmek için New-AzStorageContext 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 parametresi eklemeniz gerekir.

Parametre özellikleri

Tür:	IStorageContext
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DefaultProfile

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

Parametre özellikleri

Tür:	IAzureContextContainer
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	AzureRmContext, AzureCredential

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-EncryptionScope

Bloba istekte bulunurken kullanılacak şifreleme kapsamı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-File

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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	FullName

Parametre kümeleri

SendManual

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Metadata

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

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PremiumPageBlobTier

Sayfa Blobu Katmanı

Parametre özellikleri

Tür:	Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Default value:	None
Kabul edilen değerler:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Properties

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

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	Nullable<T>[Int32]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	ServerTimeoutPerRequestInSeconds

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Tag

Blob Etiketleri

Parametre özellikleri

Tür:	Hashtable
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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. ayrıntılarına bakın https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Çıkışlar

AzureStorageBlob

İlişkili Bağlantılar

• Get-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob