Get-AzStorageBlobContent

Modul:

Az.Storage Module

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

Syntax

ReceiveManual (Výchozí)

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

BlobPipeline

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

ContainerPipeline

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

UriPipeline

Get-AzStorageBlobContent
    -AbsoluteUri <String>
    [-Destination <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-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ími přihlašovacími údaji uživatele AAD a pak stáhnout objekt blob s identifikátorem Sas Uri i nosným tokenem.

Parametry

-AbsoluteUri

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Uri, BlobUri

Sady parametrů

UriPipeline

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

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

Vlastnosti parametru

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

Sady parametrů

ReceiveManual

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

ContainerPipeline

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

-BlobBaseClient

Objekt BlobBaseClient

Vlastnosti parametru

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

Sady parametrů

BlobPipeline

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

-CheckMd5

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

Vlastnosti parametru

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

Sady parametrů

ReceiveManual

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

BlobPipeline

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

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

Vlastnosti parametru

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

Sady parametrů

ReceiveManual

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

Vlastnosti parametru

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

Sady parametrů

ReceiveManual

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

BlobPipeline

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

ContainerPipeline

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

-Destination

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

Vlastnosti parametru

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

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

-Force

Přepíše existující soubor bez 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

-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

-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

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.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é.

Související odkazy

• Set-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob