Dela via

Set-AzStorageBlobContent

  • Referens
Modul:
Az.Storage

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

Syntax

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

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-AzStorageBlobCon tent laddar upp filerna till containern 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 parametern Force. 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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

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 godtagbara värdena för den här parametern är:

  • Block
  • Sida
  • Bifoga

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]
Alias:ClientTimeoutPerRequestInSeconds
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-AzStorageBlob.

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-AzStorageContainer.

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

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

-EncryptionScope

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

Typ:String
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, P70, P80
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]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StandardBlobTier

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

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

-Tag

Blobtaggar

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Typ:String
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örs. 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