Dela via

Set-AzureStorageBlobContent

  • Referens
Modul:
Azure.Storage

Laddar upp en lokal fil till en Azure Storage-blob.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Cmdleten Set-AzureStorageBlobContent laddar upp en lokal fil till en Azure Storage-blob.

Exempel

Exempel 1: Ladda upp en namngiven fil

PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Det här kommandot laddar upp filen med namnet PlanningData till en blob med namnet Planning2015.

Exempel 2: Ladda upp alla filer under den aktuella mappen

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"

Det här kommandot använder windows PowerShell-cmdleten Get-ChildItem för att hämta alla filer i den aktuella mappen och i undermappar och skickar dem sedan till den aktuella cmdleten med hjälp av pipelineoperatorn. Cmdleten Set-AzureStorageBlobContent laddar upp filerna till containern med namnet ContosoUploads.

Exempel 3: Skriv över en befintlig blob

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

Det här kommandot hämtar bloben Planning2015 i ContosoUploads-containern med hjälp av cmdleten Get-AzureStorageBlob och skickar sedan blobben till den aktuella cmdleten. Kommandot laddar upp filen med namnet ContosoPlanning som Planning2015. Det här kommandot anger inte force-parametern. Kommandot uppmanar dig att bekräfta. Om du bekräftar kommandot skriver cmdleten över den befintliga bloben.

Exempel 4: Ladda upp en fil till en container med hjälp av pipelinen

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

Det här kommandot hämtar containern som börjar med strängen ContosoUpload med cmdleten Get-AzureStorageContainer och skickar sedan blobben till den aktuella cmdleten. Kommandot laddar upp filen med namnet ContosoPlanning som Planning2015.

Exempel 5: Ladda upp en fil till en sidblob med metadata och PremiumPageBlobTier som P10

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

Det första kommandot skapar en hash-tabell som innehåller metadata för en blob och lagrar den hashtabellen i variabeln $Metadata. Det andra kommandot laddar upp filen med namnet ContosoPlanning till containern ContosoUploads. Bloben innehåller metadata som lagras i $Metadata och har PremiumPageBlobTier som P10.

Exempel 6: Ladda upp en fil till blob med angivna blobegenskaper

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

Det här kommandot laddar upp filen med namnet ContosoPlanning till containern ContosoUploads med angivna blobegenskaper.

Parametrar

-Blob

Anger namnet på en blob. Den här cmdleten laddar upp en fil till Azure Storage-bloben som den här parametern anger.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-BlobType

Anger typen för den blob som cmdleten laddar upp. De acceptabla värdena för den här parametern är:

  • Blockera
  • Sida Standardvärdet är Blockera.
Typ:String
Godkända värden:Block, Page, Append
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CloudBlob

Anger ett CloudBlob-objekt . Om du vill hämta ett CloudBlob-objekt använder du cmdleten Get-AzureStorageBlob.

Typ:CloudBlob
Alias:ICloudBlob
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-CloudBlobContainer

Anger ett CloudBlobContainer-objekt från Azure Storage-klientbiblioteket. Den här cmdleten laddar upp innehåll till en blob i containern som den här parametern anger. Om du vill hämta ett CloudBlobContainer-objekt använder du cmdleten Get-AzureStorageContainer.

Typ:CloudBlobContainer
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Container

Anger namnet på en container. Den här cmdleten laddar upp en fil till en blob i containern som den här parametern anger.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

Anger en Azure Storage-kontext. Om du vill hämta en lagringskontext använder du cmdleten New-AzureStorageContext. Om du vill använda en lagringskontext som skapats från en SAS-token utan läsbehörighet behöver du lägga till -Force-parametern för att hoppa över kontrollen av blob-förekomsten.

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-File

Anger en lokal filsökväg för en fil som ska laddas upp som blobinnehåll.

Typ:String
Alias:FullName
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Force

Anger att den här cmdleten skriver över en befintlig blob utan att du uppmanas att bekräfta den.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Metadata

Anger metadata för den uppladdade bloben.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PremiumPageBlobTier

Sidblobnivå

Typ:PremiumPageBlobTier
Godkända värden:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Properties

Anger egenskaper för den uppladdade bloben. De egenskaper som stöds är: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServerTimeoutPerRequest

Anger tidsgränsen för tjänstsidan i sekunder för en begäran. Om det angivna intervallet förflutit innan tjänsten bearbetar begäran returnerar lagringstjänsten ett fel.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

CloudBlobContainer

CloudBlob

IStorageContext

Utdata

AzureStorageBlob