Delen via


Set-AzStorageBlobContent

Uploadt een lokaal bestand naar een Azure Storage-blob.

Syntaxis

SendManual (Standaard)

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

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 wordt de blob met de naam Planning2015 in de Container ContosoUploads ophaalt met behulp van de Get-AzStorageBlob-cmdlet en die blob vervolgens doorgegeven 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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SendManual
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
ContainerPipeline
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-BlobType

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

  • Block
  • Page
  • Append

De standaardwaarde is Blokkeren.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Block, Page, Append
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ClientTimeoutPerRequestInSeconds

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-CloudBlob

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

Parametereigenschappen

Type:Microsoft.Azure.Storage.Blob.CloudBlob
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ICloudBlob

Parametersets

BlobPipeline
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

ContainerPipeline
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SendManual
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 -Force parameter toevoegen om het bestaan van de blob over te slaan.

Parametereigenschappen

Type:IStorageContext
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-EncryptionScope

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-File

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:FullName

Parametersets

SendManual
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Metadata

Hiermee geeft u metagegevens voor de geüploade blob.

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PremiumPageBlobTier

Pagina-bloblaag

Parametereigenschappen

Type:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Default value:None
Geaccepteerde waarden:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Properties

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

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ServerTimeoutPerRequestInSeconds

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-StandardBlobTier

Blok-bloblaag, geldige waarden zijn dynamisch/statisch/archief/koud. Zie details in https://free.blessedness.top/azure/storage/blobs/storage-blob-storage-tiers

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Tag

Blobtags

Parametereigenschappen

Type:Hashtable
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TagCondition

Optionele tagexpressie-instructie om overeenkomstvoorwaarde te controleren. De blobaanvraag mislukt wanneer de blobtags niet overeenkomen met de opgegeven expressie. Zie details in https://free.blessedness.top/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Uitvoerwaarden

AzureStorageBlob