Delen via

Set-AzureStorageBlobContent

  • Referentie
Module:
Azure.Storage

Uploadt een lokaal bestand naar een Azure Storage-blob.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

Voorbeelden

Voorbeeld 1: Een benoemd bestand uploaden

PS C:\>Set-AzureStorageBlobContent -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

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -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-AzureStorageBlobContent uploadt de bestanden naar de container met de naam ContosoUploads.

Voorbeeld 3: Een bestaande blob overschrijven

PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"

Met deze opdracht haalt u de blob met de naam Planning2015 op in de Container ContosoUploads met behulp van de Cmdlet Get-AzureStorageBlob en geeft 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

PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Met deze opdracht wordt de container ophaalt die begint met de tekenreeks ContosoUpload met behulp van de cmdlet Get-AzureStorageContainer 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

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -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

PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}

Met deze opdracht wordt het bestand met de naam ContosoPlanning geüpload naar de container met de naam ContosoUploads met opgegeven blobeigenschappen.

Parameters

-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 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]
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-AzureStorageBlob 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-AzureStorageContainer om een CloudBlobContainer-object te verkrijgen.

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-AzureStorageContext 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 de bestaande 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

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