Get-AzStorageBlob

Reference

Modul:: Az.Storage

Vypíše objekty blob v kontejneru.

Syntaxe

Get-AzStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -SnapshotTime <DateTimeOffset>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -VersionId <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Get-AzStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeVersion]
   [-IncludeTag]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

Rutina Get-AzStorageBlob vypíše objekty blob v zadaném kontejneru v účtu úložiště Azure.

Příklady

Příklad 1: Získání objektu blob podle názvu objektu blob

Get-AzStorageBlob -Container "ContainerName" -Blob blob*

Tento příkaz k získání objektu blob používá název objektu blob a zástupný znak.

Příklad 2: Získání objektů blob v kontejneru pomocí kanálu

Get-AzStorageContainer -Name container* | Get-AzStorageBlob -IncludeDeleted

Container Uri: https://storageaccountname.blob.core.windows.net/container1

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime         IsDeleted 
----                 --------  ------          -----------                    ------------         ---------- ------------         --------- 
test1                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:19Z            2017-11-08 08:19:32Z True      
test1                BlockBlob 403116          application/octet-stream       2017-11-08 09:00:29Z                                 True      
test2                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:00Z                                 False

Tento příkaz používá kanál k získání všech objektů blob (včetně objektů blob ve stavu Odstraněno) v kontejneru.

Příklad 3: Získání objektů blob podle předpony názvu

Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"

Tento příkaz používá k získání objektů blob předponu názvu.

Příklad 4: Výpis objektů blob v několika dávkách

$MaxReturn = 10000
$ContainerName = "abc"
$Total = 0
$Token = $Null
do
 {
     $Blobs = Get-AzStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($null -ne $Token)
Echo "Total $Total blobs in container $ContainerName"

Tento příklad používá parametry MaxCount a ContinuationToken k výpisu objektů blob služby Azure Storage v několika dávkách. První čtyři příkazy přiřazují hodnoty proměnným, které se mají použít v příkladu. Pátý příkaz určuje příkaz Do-While , který k získání objektů blob používá rutinu Get-AzStorageBlob . Příkaz obsahuje token pokračování uložený v proměnné $Token. $Token se při spuštění smyčky změní hodnota. Další informace potřebujete zadáním Get-Help About_Do. Poslední příkaz použije příkaz Echo k zobrazení součtu.

Příklad 5: Získání všech objektů blob v kontejneru zahrnuje verzi objektu blob

Get-AzStorageBlob -Container "containername"  -IncludeVersion

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.2432658Z  
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False                                    
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.8598431Z *  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:35Z Hot                                     False      2020-07-03T16:19:35.2381110Z *

Tento příkaz získá všechny objekty blob v kontejneru včetně verze objektu blob.

Příklad 6: Získání verze jednoho objektu blob

Get-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z

Tento příkaz získá jeden objekt blob s VersionId.

Příklad 7: Získání jednoho snímku objektu blob

Get-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False

Tento příkaz získá jeden snímek objektu blob se snímkem SnapshotTime.

Příklad 8: Získání objektů blob zahrnuje značky objektů blob

$blobs = Get-AzStorageBlob -Container "containername" -IncludeTag

$blobs

   AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *
testblob2            BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:04Z Hot                                     False      2020-07-23T09:35:04.0856187Z *


$blobs[0].Tags
Name          Value 
----          -----
tag1          value1
tag2          value2

Tento příkaz vypíše objekty blob z kontejneru se značkami objektů blob a zobrazí značky prvního objektu blob.

Příklad 9: Získání jednoho objektu blob s podmínkou značky objektu blob

Get-AzStorageBlob -Container "containername" -Blob testblob -TagCondition """tag1""='value1'"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *

Tento příkaz získá jeden objekt blob s podmínkou značky objektu blob. Rutina bude úspěšná pouze v případě, že objekt blob obsahuje značku s názvem "tag1" a hodnotou "value1", jinak rutina selže s kódem chyby 412.

Parametry

-Blob

Určuje název nebo vzor názvu, který se dá použít pro vyhledávání se zástupnými znaků. Pokud není zadán žádný název objektu blob, rutina vypíše všechny objekty blob v zadaném kontejneru. Pokud je pro tento parametr zadána hodnota, zobrazí rutina seznam všech objektů blob s názvy, které odpovídají tomuto parametru. Tento parametr podporuje zástupné znaky kdekoli v řetězci.

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

-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

-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

-Container

Určuje název kontejneru.

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

-Context

Určuje účet úložiště Azure, ze kterého chcete získat seznam objektů 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

-ContinuationToken

Určuje token pokračování pro seznam objektů blob. Pomocí tohoto parametru a parametru MaxCount můžete vypsat objekty blob v několika dávkách.

Typ:	BlobContinuationToken
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
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

-IncludeDeleted

Zahrnout odstraněný objekt blob, ve výchozím nastavení objekt blob nebude obsahovat odstraněný objekt blob.

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

-IncludeTag

Zahrnout značky objektů blob, ve výchozím nastavení objekt blob nebude obsahovat značky objektů blob.

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

-IncludeVersion

Verze objektů blob budou uvedené pouze v případě, že je tento parametr k dispozici, ve výchozím nastavení nebude objekt blob obsahovat verze objektů blob.

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

-MaxCount

Určuje maximální počet objektů, které tato rutina vrátí.

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

-Prefix

Určuje předponu pro názvy objektů blob, které chcete získat. Tento parametr nepodporuje vyhledávání pomocí regulárních výrazů ani zástupných znaků. To znamená, že pokud kontejner obsahuje pouze objekty blob s názvem My, MyBlob1 a MyBlob2 a zadáte -Prefix My*, rutina nevrátí žádné objekty blob. Pokud však zadáte "-Prefix My", rutina vrátí "My", "MyBlob1" a "MyBlob2".

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

-SnapshotTime

Blob SnapshotTime

Typ:	Nullable<T>[DateTimeOffset]
Position:	Named
Default value:	None
Vyžadováno:	True
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://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

-VersionId

Id verze objektu blob

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

Vstupy

String

IStorageContext

Výstupy

AzureStorageBlob

Sdílet prostřednictvím

Get-AzStorageBlob

Syntaxe

Description

Příklady

Příklad 1: Získání objektu blob podle názvu objektu blob

Příklad 2: Získání objektů blob v kontejneru pomocí kanálu

Příklad 3: Získání objektů blob podle předpony názvu

Příklad 4: Výpis objektů blob v několika dávkách

Příklad 5: Získání všech objektů blob v kontejneru zahrnuje verzi objektu blob

Příklad 6: Získání verze jednoho objektu blob

Příklad 7: Získání jednoho snímku objektu blob

Příklad 8: Získání objektů blob zahrnuje značky objektů blob

Příklad 9: Získání jednoho objektu blob s podmínkou značky objektu blob

Parametry

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Get-AzStorageBlob

Syntaxe

Description

Příklady

Příklad 1: Získání objektu blob podle názvu objektu blob

Příklad 2: Získání objektů blob v kontejneru pomocí kanálu

Příklad 3: Získání objektů blob podle předpony názvu

Příklad 4: Výpis objektů blob v několika dávkách

Příklad 5: Získání všech objektů blob v kontejneru zahrnuje verzi objektu blob

Příklad 6: Získání verze jednoho objektu blob

Příklad 7: Získání jednoho snímku objektu blob

Příklad 8: Získání objektů blob zahrnuje značky objektů blob

Příklad 9: Získání jednoho objektu blob s podmínkou značky objektu blob

Parametry

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Vstupy

Výstupy

Související odkazy

Další materiály