Sdílet prostřednictvím

Set-AzStorageBlobContent

  • Reference
Modul:
Az.Storage

Nahraje místní soubor do objektu blob služby Azure Storage.

Syntaxe

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

Rutina Set-AzStorageBlobContent nahraje místní soubor do objektu blob služby Azure Storage.

Příklady

Příklad 1: Nahrání pojmenovaného souboru

Set-AzStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Tento příkaz nahraje soubor s názvem PlanningData do objektu blob s názvem Planning2015.

Příklad 2: Nahrání všech souborů v aktuální složce

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

Tento příkaz používá základní rutinu Windows PowerShellu Get-ChildItem k získání všech souborů v aktuální složce a v podsložkách a jejich následném předá aktuální rutině pomocí operátoru kanálu. Rutina Set-AzStorageBlobContent nahraje soubory do kontejneru s názvem ContosoUploads.

Příklad 3: Přepsání existujícího objektu blob

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

Tento příkaz získá objekt blob s názvem Planning2015 v kontejneru ContosoUploads pomocí rutiny Get-AzStorageBlob a pak tento objekt blob předá aktuální rutině. Příkaz nahraje soubor s názvem ContosoPlanning jako Planning2015. Tento příkaz nezadá parametr Force. Příkaz vás vyzve k potvrzení. Pokud příkaz potvrdíte, rutina přepíše existující objekt blob.

Příklad 4: Nahrání souboru do kontejneru pomocí kanálu

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

Tento příkaz získá kontejner, který začíná řetězcem ContosoUpload pomocí rutiny Get-AzStorageContainer a pak tento objekt blob předá aktuální rutině. Příkaz nahraje soubor s názvem ContosoPlanning jako Planning2015.

Příklad 5: Nahrání souboru do objektu blob stránky s metadaty a PremiumPageBlobTier jako P10

$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

První příkaz vytvoří tabulku hash obsahující metadata objektu blob a uloží ji do $Metadata proměnné. Druhý příkaz nahraje soubor s názvem ContosoPlanning do kontejneru s názvem ContosoUploads. Objekt blob obsahuje metadata uložená v $Metadata a má PremiumPageBlobTier jako P10.

Příklad 6: Nahrání souboru do objektu blob se zadanými vlastnostmi objektu blob a nastavení StandardBlobTier jako Cool

$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

Tento příkaz nahraje soubor c:\temp\index.html do kontejneru s názvem contosouploads se zadanými vlastnostmi objektu blob a nastaví StandardBlobTier jako Cool. Tento příkaz získá hodnotu ContentType nastavenou na vlastnosti objektu blob pomocí rozhraní API [System.Web.MimeMapping]::GetMimeMapping().

Příklad 7: Nahrání souboru do objektu blob s oborem šifrování

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

$blob.BlobProperties.EncryptionScope

myencryptscope

Tento příkaz nahraje soubor do objektu blob s oborem šifrování.

Parametry

-AsJob

Spusťte rutinu na pozadí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Blob

Určuje název objektu blob. Tato rutina nahraje soubor do objektu blob služby Azure Storage, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BlobType

Určuje typ objektu blob, který tato rutina nahraje. Přijatelné hodnoty pro tento parametr jsou:

  • Blokovat
  • Stránka
  • Připojit

Výchozí hodnota je Block.

Typ:String
Přípustné hodnoty:Block, Page, Append
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ClientTimeoutPerRequest

Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.

Typ:Nullable<T>[Int32]
Aliasy:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CloudBlob

Určuje objekt CloudBlob. K získání objektu CloudBlob použijte rutinu Get-AzStorageBlob.

Typ:CloudBlob
Aliasy:ICloudBlob
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-CloudBlobContainer

Určuje objekt CloudBlobContainer z klientské knihovny služby Azure Storage. Tato rutina nahraje obsah do objektu blob v kontejneru, který tento parametr určuje. K získání objektu CloudBlobContainer použijte rutinu Get-AzStorageContainer.

Typ:CloudBlobContainer
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ConcurrentTaskCount

Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.

Typ:Nullable<T>[Int32]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Container

Určuje název kontejneru. Tato rutina nahraje soubor do objektu blob v kontejneru, který tento parametr určuje.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Context

Určuje kontext úložiště Azure. K získání kontextu úložiště použijte rutinu New-AzStorageContext. Pokud chcete použít kontext úložiště vytvořený z tokenu SAS bez oprávnění ke čtení, musíte přidat parametr -Force, aby se přeskočí kontrola existence objektu blob.

Typ:IStorageContext
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EncryptionScope

Obor šifrování, který se má použít při provádění požadavků na objekt blob.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-File

Určuje místní cestu k souboru, který se má nahrát jako obsah objektu blob.

Typ:String
Aliasy:FullName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Force

Označuje, že tato rutina přepíše existující objekt blob bez výzvy k potvrzení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Metadata

Určuje metadata nahraného objektu blob.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PremiumPageBlobTier

Úroveň objektu blob stránky

Typ:PremiumPageBlobTier
Přípustné hodnoty:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Properties

Určuje vlastnosti nahraného objektu blob. Podporované vlastnosti jsou: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ServerTimeoutPerRequest

Určuje interval časového limitu na straně služby v sekundách pro požadavek. Pokud zadaný interval uplynou před tím, než služba zpracuje požadavek, služba úložiště vrátí chybu.

Typ:Nullable<T>[Int32]
Aliasy:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-StandardBlobTier

Úroveň objektu blob bloku, platné hodnoty jsou horká, studená, archivní/ studená. Zobrazit podrobnosti v https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Značky objektů blob

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TagCondition

Volitelný příkaz výrazu Tag pro kontrolu podmínky shody. Požadavek na objekt blob selže, pokud značky objektů blob neodpovídají danému výrazu. Podrobnosti najdete v https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

CloudBlobContainer

CloudBlob

IStorageContext

Výstupy

AzureStorageBlob