Get-AzStorageBlobContent

  • Reference
Modul:
Az.Storage

Stáhne objekt blob úložiště.

Syntaxe

Get-AzStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Get-AzStorageBlobContent stáhne zadaný objekt blob úložiště. Pokud název objektu blob není platný pro místní počítač, tato rutina ji automaticky přeloží, pokud je to možné.

Příklady

Příklad 1: Stažení obsahu objektu blob podle názvu

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Tento příkaz stáhne objekt blob podle názvu.

Příklad 2: Stažení obsahu objektu blob pomocí kanálu

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

Tento příkaz používá kanál k vyhledání a stažení obsahu objektu blob.

Příklad 3: Stažení obsahu objektu blob pomocí kanálu a zástupné znaky

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

Tento příklad používá zástupný znak hvězdičky a kanál k vyhledání a stažení obsahu objektu blob.

Příklad 4: Získání objektu blob a jeho uložení do proměnné a následné stažení obsahu objektu blob s objektem blob

$blob = Get-AzStorageBlob -Container containername -Blob blobname 
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

Tento příklad nejprve získá objekt blob a uloží ho do proměnné a pak stáhne obsah objektu blob s objektem blob.

Příklad 5: Stažení obsahu objektu blob s identifikátorem URI objektu blob

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

Tento příklad stáhne obsah objektu blob s identifikátorem URI, identifikátor URI může být identifikátor URI s tokenem Sas. Pokud je objekt blob ve spravovaném účtu disku a server vyžaduje kromě identifikátoru URI Sas ke stažení nosný token, rutina se pokusí vygenerovat nosný token s vrácenou cílovou skupinou serveru a přihlašovacím přihlašovacím identifikátorem uživatele AAD a pak stáhne objekt blob s identifikátorem Sas Uri i nosným tokenem.

Parametry

-AbsoluteUri

Identifikátor URI objektu blob, ze které se má stáhnout.

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

-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, který se má stáhnout.

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

-BlobBaseClient

Objekt BlobBaseClient

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

-CheckMd5

Určuje, jestli chcete zkontrolovat součet Md5 pro stažený soubor.

Typ:SwitchParameter
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 cloudový objekt blob. 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 úložiště Azure. Můžete ho vytvořit nebo použít 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 zobrazí výzvu 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, který má objekt blob, který chcete stáhnout.

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 účet úložiště Azure, ze kterého chcete stáhnout obsah objektu blob. K vytvoření kontextu úložiště můžete použít rutinu New-AzStorageContext.

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

-Destination

Určuje umístění pro uložení staženého souboru.

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

-Force

Přepíše existující soubor bez potvrzení.

Typ:SwitchParameter
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

-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://video2.skills-academy.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

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

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

CloudBlob

CloudBlobContainer

IStorageContext

Výstupy

AzureStorageBlob

Poznámky

  • Pokud je název objektu blob pro místní počítač neplatný, tato rutina ji automaticky vypustí, pokud je to možné.