Set-AzStorageBlobContent

Reference

Modul:: Az.Storage

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

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

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 pomocí základní rutiny Windows PowerShellu Get-ChildItem získá všechny soubory v aktuální složce a v podsložkách a pak je 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í.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Blob

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlobType

Určuje typ objektu blob, který tato rutina nahraje. Tento parametr přijímá tyto hodnoty:

Blok
Page
Připojit

Výchozí hodnota je Block.

Type:	String
Accepted values:	Block, Page, Append
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CloudBlob

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

Type:	CloudBlob
Aliases:	ICloudBlob
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	CloudBlobContainer
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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, který přeskočí kontrolu existence objektu blob.

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionScope

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-File

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

Type:	String
Aliases:	FullName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metadata

Určuje metadata nahraného objektu blob.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PremiumPageBlobTier

Úroveň objektu blob stránky

Type:	PremiumPageBlobTier
Accepted values:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Properties

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

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Značky objektů blob

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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. Podívejte se na podrobnosti na stránce https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

String

CloudBlobContainer

CloudBlob

IStorageContext

Výstupy

AzureStorageBlob

Set-AzStorageBlobContent

Syntax

Description

Příklady

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

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

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

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

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

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

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

Parametry

-AsJob

-Blob

-BlobType

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Container

-Context

-DefaultProfile

-EncryptionScope

-File

-Force

-Metadata

-PremiumPageBlobTier

-Properties

-ServerTimeoutPerRequest

-StandardBlobTier

-Tag

-TagCondition

-WhatIf

Vstupy

Výstupy

Váš názor

Další materiály

Set-AzStorageBlobContent

Syntax

Description

Příklady

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

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

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

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

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

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

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

Parametry

-AsJob

-Blob

-BlobType

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Container

-Context

-DefaultProfile

-EncryptionScope

-File

-Force

-Metadata

-PremiumPageBlobTier

-Properties

-ServerTimeoutPerRequest

-StandardBlobTier

-Tag

-TagCondition

-WhatIf

Vstupy

Výstupy

Související odkazy

Váš názor

Další materiály