Delen via


Set-AzStorageBlobContent

Uploadt een lokaal bestand naar een Azure Storage-blob.

Syntaxis

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

De cmdlet Set-AzStorageBlobContent uploadt een lokaal bestand naar een Azure Storage-blob.

Voorbeelden

Voorbeeld 1: Een benoemd bestand uploaden

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

Met deze opdracht wordt het bestand met de naam PlanningData geüpload naar een blob met de naam Planning2015.

Voorbeeld 2: Alle bestanden uploaden onder de huidige map

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

Met deze opdracht wordt de Windows PowerShell-kern-cmdlet Get-ChildItem gebruikt om alle bestanden in de huidige map en in submappen op te halen en deze vervolgens door te geven aan de huidige cmdlet met behulp van de pijplijnoperator. De cmdlet Set-AzStorageBlobContent uploadt de bestanden naar de container met de naam ContosoUploads.

Voorbeeld 3: Een bestaande blob overschrijven

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

Met deze opdracht haalt u de blob met de naam Planning2015 op in de Container ContosoUploads met behulp van de Cmdlet Get-AzStorageBlob en geeft u die blob vervolgens door aan de huidige cmdlet. Met de opdracht wordt het bestand met de naam ContosoPlanning geüpload als Planning2015. Met deze opdracht wordt de parameter Force niet opgegeven. De opdracht vraagt u om bevestiging. Als u de opdracht bevestigt, overschrijft de cmdlet de bestaande blob.

Voorbeeld 4: Een bestand uploaden naar een container met behulp van de pijplijn

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

Met deze opdracht wordt de container ophaalt die begint met de tekenreeks ContosoUpload met behulp van de cmdlet Get-AzStorageContainer en die blob vervolgens doorgeeft aan de huidige cmdlet. Met de opdracht wordt het bestand met de naam ContosoPlanning geüpload als Planning2015.

Voorbeeld 5: Een bestand uploaden naar pagina-blob met metagegevens en PremiumPageBlobTier als P10

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

Met de eerste opdracht maakt u een hash-tabel met metagegevens voor een blob en slaat u die hash-tabel op in de $Metadata variabele. Met de tweede opdracht wordt het bestand met de naam ContosoPlanning geüpload naar de container met de naam ContosoUploads. De blob bevat de metagegevens die zijn opgeslagen in $Metadata en heeft PremiumPageBlobTier als P10.

Voorbeeld 6: Een bestand uploaden naar een blob met opgegeven blobeigenschappen en StandardBlobTier instellen als Statisch

$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

Met deze opdracht uploadt u het bestand c:\temp\index.html naar de container met de naam contosouploads met opgegeven blobeigenschappen en stelt u StandardBlobTier in als Statisch. Met deze opdracht wordt de ContentType-waarde ingesteld op blob-eigenschappen door [System.Web.MimeMapping]::GetMimeMapping() API.

Voorbeeld 7: Een bestand uploaden naar een blob met versleutelingsbereik

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

$blob.BlobProperties.EncryptionScope

myencryptscope

Met deze opdracht wordt een bestand geüpload naar een blob met versleutelingsbereik.

Parameters

-AsJob

Voer de cmdlet op de achtergrond uit.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Blob

Hiermee geeft u de naam van een blob. Met deze cmdlet wordt een bestand geüpload naar de Azure Storage-blob die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BlobType

Hiermee geeft u het type op voor de blob die door deze cmdlet wordt geüpload. De aanvaardbare waarden voor deze parameter zijn:

  • Blokkeren
  • Pagina
  • Toevoegen

De standaardwaarde is Blokkeren.

Type:String
Geaccepteerde waarden:Block, Page, Append
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Aliassen:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CloudBlob

Hiermee geeft u een CloudBlob-object op. Gebruik de cmdlet Get-AzStorageBlob om een CloudBlob-object te verkrijgen.

Type:CloudBlob
Aliassen:ICloudBlob
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CloudBlobContainer

Hiermee geeft u een CloudBlobContainer-object op uit de Azure Storage-clientbibliotheek. Met deze cmdlet wordt inhoud geüpload naar een blob in de container die met deze parameter wordt opgegeven. Gebruik de cmdlet Get-AzStorageContainer om een CloudBlobContainer-object op te halen.

Type:CloudBlobContainer
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Container

Hiermee geeft u de naam van een container. Met deze cmdlet wordt een bestand geüpload naar een blob in de container die met deze parameter wordt opgegeven.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Hiermee geeft u een Azure-opslagcontext op. Gebruik de cmdlet New-AzStorageContext om een opslagcontext te verkrijgen. Als u een opslagcontext wilt gebruiken die is gemaakt op basis van een SAS-token zonder leesmachtiging, moet u de parameter -Force toevoegen om het bestaan van de blob over te slaan.

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EncryptionScope

Versleutelingsbereik dat moet worden gebruikt bij het indienen van aanvragen voor de blob.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-File

Hiermee geeft u een lokaal bestandspad op voor een bestand dat moet worden geüpload als blobinhoud.

Type:String
Aliassen:FullName
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Geeft aan dat deze cmdlet een bestaande blob overschrijft zonder dat u om bevestiging wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metadata

Hiermee geeft u metagegevens voor de geüploade blob.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PremiumPageBlobTier

Pagina-bloblaag

Type:PremiumPageBlobTier
Geaccepteerde waarden:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Properties

Hiermee geeft u eigenschappen voor de geüploade blob. De ondersteunde eigenschappen zijn: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

Type:Nullable<T>[Int32]
Aliassen:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StandardBlobTier

Blok-bloblaag, geldige waarden zijn dynamisch/statisch/archief/koud. Zie details in https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Blobtags

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TagCondition

Optionele tagexpressie-instructie om overeenkomstvoorwaarde te controleren. De blobaanvraag mislukt wanneer de blobtags niet overeenkomen met de opgegeven expressie. Zie voor details 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

CloudBlobContainer

CloudBlob

IStorageContext

Uitvoerwaarden

AzureStorageBlob