Dela via


Set-AzStorageBlobContent

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

Syntax

SendManual (Standard)

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

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

Exempel

Exempel 1: Ladda upp en namngiven fil

Set-AzStorageBlobContent -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

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

Det här kommandot använder den centrala 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-AzStorageBlobContent laddar upp filerna till containern med namnet ContosoUploads.

Exempel 3: Skriv över en befintlig blob

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

Det här kommandot hämtar bloben Planning2015 i containern ContosoUploads med hjälp av cmdleten Get-AzStorageBlob 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

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

Det här kommandot hämtar containern som börjar med strängen ContosoUpload med hjälp av cmdleten Get-AzStorageContainer 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

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -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 och ange StandardBlobTier som Lågfrekvent

$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

Det här kommandot överför filen c:\temp\index.html till containern med namnet contosouploads med angivna blobegenskaper och anger StandardBlobTier som Lågfrekvent. Det här kommandot hämtar ContentType-värdet inställt på blobegenskaper av [System.Web.MimeMapping]::GetMimeMapping() API.

Exempel 7: Ladda upp en fil till en blob med krypteringsomfång

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

$blob.BlobProperties.EncryptionScope
myencryptscope

Det här kommandot laddar upp en fil till en blob med krypteringsomfång.

Parametrar

-AsJob

Kör cmdleten i bakgrunden.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Blob

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SendManual
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
ContainerPipeline
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-BlobType

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

  • Blockera
  • Sida
  • Append

Standardvärdet är Blockera.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Block, Page, Append
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-CloudBlob

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

Parameteregenskaper

Typ:Microsoft.Azure.Storage.Blob.CloudBlob
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ICloudBlob

Parameteruppsättningar

BlobPipeline
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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-AzStorageContainer.

Parameteregenskaper

Typ:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ContainerPipeline
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SendManual
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Context

Anger en Azure Storage-kontext. Om du vill hämta en lagringskontext använder du cmdleten New-AzStorageContext. 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 parameter för att hoppa över kontrollen av blobexistensen.

Parameteregenskaper

Typ:IStorageContext
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EncryptionScope

Krypteringsomfång som ska användas vid begäranden till bloben.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-File

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Fullständigt Namn

Parameteruppsättningar

SendManual
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Force

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Metadata

Anger metadata för den uppladdade bloben.

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-PremiumPageBlobTier

Sidblobnivå

Parameteregenskaper

Typ:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Standardvärde:None
Godkända värden:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Properties

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

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-StandardBlobTier

Blockblobnivå, giltiga värden är Frekvent/Lågfrekvent/Arkiv/Kall. Mer information finns i https://free.blessedness.top/azure/storage/blobs/storage-blob-storage-tiers

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Tag

Blobtaggar

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TagCondition

Valfritt uttrycksuttryck för tagg för att kontrollera matchningsvillkoret. Blobbegäran misslyckas när blobtaggar inte matchar det angivna uttrycket. Se information i https://free.blessedness.top/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Utdata

AzureStorageBlob