Share via

Set-AzStorageBlobContent

  • Referencia
Modul:
Az.Storage

Feltölt egy helyi fájlt egy Azure Storage-blobba.

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

A Set-AzStorageBlobContent parancsmag feltölt egy helyi fájlt egy Azure Storage-blobba.

Példák

1. példa: Névvel ellátott fájl feltöltése

Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Ez a parancs feltölti a PlanningData nevű fájlt egy Planning2015 nevű blobba.

2. példa: Az összes fájl feltöltése az aktuális mappában

Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -Container "ContosoUploads"

Ez a parancs a Get-ChildItem alapvető Windows PowerShell-parancsmagot használja az aktuális mappában és almappákban lévő összes fájl lekéréséhez, majd a folyamatkezelővel átadja azokat az aktuális parancsmagnak. A Set-AzStorageBlobContent parancsmag feltölti a fájlokat a ContosoUploads nevű tárolóba.

3. példa: Meglévő blob felülírása

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

Ez a parancs a Get-AzStorageBlob parancsmaggal lekéri a ContosoUploads tárolóban a Planning2015 nevű blobot, majd átadja a blobot az aktuális parancsmagnak. A parancs feltölti a ContosoPlanning nevű fájlt Tervezés2015 néven. Ez a parancs nem adja meg a Force paramétert. A parancssor megerősítést kér. Ha megerősíti a parancsot, a parancsmag felülírja a meglévő blobot.

4. példa: Fájl feltöltése tárolóba a folyamat használatával

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

Ez a parancs lekéri a ContosoUpload sztringgel kezdődő tárolót a Get-AzStorageContainer parancsmaggal, majd átadja a blobot az aktuális parancsmagnak. A parancs feltölti a ContosoPlanning nevű fájlt Tervezés2015 néven.

5. példa: Fájl feltöltése lapblobba metaadatokkal és PremiumPageBlobTier p10-ként

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

Az első parancs létrehoz egy kivonattáblát, amely egy blob metaadatait tartalmazza, és tárolja a kivonattáblát a $Metadata változóban. A második parancs feltölti a ContosoPlanning nevű fájlt a ContosoUploads nevű tárolóba. A blob tartalmazza a $Metadata tárolt metaadatokat, a PremiumPageBlobTier pedig P10.

6. példa: Fájl feltöltése megadott blobtulajdonságokkal rendelkező blobba, és a StandardBlobTier beállítása ritka elérésűként

$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

Ez a parancs feltölti a c:\temp\index.html fájlt a contosouploads nevű tárolóba a megadott blobtulajdonságokkal, és a StandardBlobTiert cool értékre állítja. Ez a parancs blobtulajdonságokra állítja be a ContentType értéket a [System.Web.MimeMapping]::GetMimeMapping() API használatával.

7. példa: Fájl feltöltése titkosítási hatókörrel rendelkező blobba

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

$blob.BlobProperties.EncryptionScope

myencryptscope

Ez a parancs feltölt egy fájlt egy titkosítási hatókörrel rendelkező blobba.

Paraméterek

-AsJob

Futtassa a parancsmagot a háttérben.

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

-Blob

Egy blob nevét adja meg. Ez a parancsmag feltölt egy fájlt a paraméter által megadott Azure Storage-blobba.

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

-BlobType

Megadja a parancsmag által feltöltött blob típusát. A paraméter elfogadható értékei a következők:

  • Letiltás
  • Oldal
  • Hozzáfűzés

Az alapértelmezett érték a Blokk.

Type:String
Accepted values:Block, Page, Append
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

Egy szolgáltatáskérés ügyféloldali időtúllépési időközét adja meg másodpercben. Ha az előző hívás a megadott időközönként meghiúsul, a parancsmag újrapróbálkozza a kérést. Ha ez a parancsmag nem kap sikeres választ az időköz eltelte előtt, ez a parancsmag hibát ad vissza.

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

-CloudBlob

CloudBlob-objektumot ad meg. CloudBlob-objektum beszerzéséhez használja a Get-AzStorageBlob parancsmagot.

Type:CloudBlob
Aliases:ICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

Egy CloudBlobContainer-objektumot határoz meg az Azure Storage-ügyfélkódtárból. Ez a parancsmag feltölti a tartalmat egy blobba a paraméter által megadott tárolóban. CloudBlobContainer-objektum beszerzéséhez használja a Get-AzStorageContainer parancsmagot.

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

-ConcurrentTaskCount

Az egyidejű hálózati hívások maximális száma. Ezzel a paramétersel korlátozhatja az egyidejűséget a helyi processzor- és sávszélesség-használat szabályozására az egyidejű hálózati hívások maximális számának megadásával. A megadott érték abszolút szám, és nem szorozza meg a magok számával. Ez a paraméter segíthet csökkenteni a hálózati csatlakozási problémákat alacsony sávszélességű környezetekben, például másodpercenként 100 kilobitben. Az alapértelmezett érték 10.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Container

Egy tároló nevét adja meg. Ez a parancsmag feltölt egy fájlt egy blobba a paraméter által megadott tárolóban.

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

-Context

Egy Azure Storage-környezetet határoz meg. A tárolási környezet beszerzéséhez használja a New-AzStorageContext parancsmagot. Ha olvasási engedély nélkül szeretne SAS-jogkivonatból létrehozott tárolókörnyezetet használni, a blob meglétének ellenőrzésének kihagyásához hozzá kell adnia a -Force paramétert.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-EncryptionScope

A blobra irányuló kérések során használandó titkosítási hatókör.

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

-File

Megadja a blobtartalomként feltöltendő fájlok helyi fájlelérési útját.

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

-Force

Azt jelzi, hogy ez a parancsmag felülír egy meglévő blobot anélkül, hogy megerősítést kér.

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

-Metadata

A feltöltött blob metaadatait adja meg.

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

-PremiumPageBlobTier

Lapblobszint

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

Megadja a feltöltött blob tulajdonságait. A támogatott tulajdonságok a következők: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

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

-ServerTimeoutPerRequest

A szolgáltatásoldali időtúllépési időközt adja meg másodpercben egy kéréshez. Ha a megadott időköz el nem telik, mielőtt a szolgáltatás feldolgozza a kérést, a tárolási szolgáltatás hibát ad vissza.

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

-StandardBlobTier

Blokkblobszint, az érvényes értékek a gyakori elérésű/ritka elérésű/archív/hideg értékek. Részletek a következőben: 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

Blobcímkék

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

-TagCondition

Nem kötelező címkekifejezési utasítás az egyezés feltételének ellenőrzéséhez. A blobkérés sikertelen lesz, ha a blobcímkék nem felelnek meg a megadott kifejezésnek. Részletekért lásd: 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

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

String

CloudBlobContainer

CloudBlob

IStorageContext

Kimenetek

AzureStorageBlob