Sdílet prostřednictvím

Set-AzStorageBlobContent

Modul:
Az.Storage Module

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

Syntax

SendManual (Výchozí) 

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

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Blob

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SendManual
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
ContainerPipeline
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-BlobType

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

  • Block
  • Stránka
  • Append

Výchozí hodnota je Block.

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Block, Page, Append
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-CloudBlob

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

Vlastnosti parametru

Typ:Microsoft.Azure.Storage.Blob.CloudBlob
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ICloudBlob

Sady parametrů

BlobPipeline
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:Microsoft.Azure.Storage.Blob.CloudBlobContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

ContainerPipeline
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Container

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SendManual
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:IStorageContext
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-EncryptionScope

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-File

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Celé jméno

Sady parametrů

SendManual
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Force

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Metadata

Určuje metadata nahraného objektu blob.

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-PremiumPageBlobTier

Úroveň objektu blob stránky

Vlastnosti parametru

Typ:Microsoft.Azure.Storage.Blob.PremiumPageBlobTier
Default value:None
Přípustné hodnoty:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Properties

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

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-StandardBlobTier

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

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Tag

Značky objektů blob

Vlastnosti parametru

Typ:Hashtable
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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-operationstématu .

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Microsoft.Azure.Storage.Blob.CloudBlobContainer

Microsoft.Azure.Storage.Blob.CloudBlob

IStorageContext

Výstupy

AzureStorageBlob