Megosztás a következőn keresztül:

Get-AzureStorageBlob

  • Referencia
Modul:
Azure.Storage

A tárolóban lévő blobokat listázza.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

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

Description

A Get-AzureStorageBlob parancsmag egy Azure Storage-fiók megadott tárolójában lévő blobokat sorolja fel.

Példák

1. példa: Blob lekérése blobnév alapján

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

Ez a parancs blobnevet és helyettesítő karaktert használ a blob lekéréséhez.

2. példa: Blobok lekérése egy tárolóban a folyamat használatával

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob -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

Ez a parancs a folyamat használatával lekéri az összes blobot (a törölt állapotú blobokat is belefoglalva) egy tárolóba.

3. példa: Blobok lekérése névelőtag alapján

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Prefix "blob"

Ez a parancs névelőtagot használ a blobok lekéréséhez.

4. példa: Blobok listázása több kötegben

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

Ez a példa a MaxCount és a ContinuationToken paraméterekkel listázza az Azure Storage-blobokat több kötegben. Az első négy parancs értékeket rendel a példában használandó változókhoz. Az ötödik parancs egy Do-While utasítást ad meg, amely a Get-AzureStorageBlob parancsmagot használja a blobok lekéréséhez. Az utasítás tartalmazza a $Token változóban tárolt folytatási jogkivonatot. $Token a ciklus futtatásakor módosítja az értéket. További információkért írja be a következőt Get-Help About_Do: Az utolsó parancs az Echo paranccsal jeleníti meg a végösszeget.

Paraméterek

-Blob

Megadja a helyettesítő karakterek kereséséhez használható nevet vagy névmintát. Ha nincs megadva blobnév, a parancsmag felsorolja a megadott tárolóban lévő összes blobot. Ha egy érték van megadva ehhez a paraméterhez, a parancsmag felsorolja az összes olyan blobot, amelynek neve megegyezik ezzel a paraméterrel.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ClientTimeoutPerRequest

Egy szolgáltatáskérés ügyféloldali időtúllépési időközét adja meg másodpercben. Ha az előző hívás a megadott időközönként meghiúsul, a parancsmag újrapróbálkozza a kérést. Ha ez a parancsmag nem kap sikeres választ az időköz eltelte előtt, ez a parancsmag hibát ad vissza.

Típus:Nullable<T>[Int32]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ConcurrentTaskCount

Az egyidejű hálózati hívások maximális száma. Ezzel a paramétersel korlátozhatja az egyidejűséget a helyi processzor- és sávszélesség-használat szabályozására az egyidejű hálózati hívások maximális számának megadásával. A megadott érték abszolút szám, és nem szorozza meg a magok számával. Ez a paraméter segíthet csökkenteni a hálózati csatlakozási problémákat alacsony sávszélességű környezetekben, például másodpercenként 100 kilobitben. Az alapértelmezett érték 10.

Típus:Nullable<T>[Int32]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Container

Megadja a tároló nevét.

Típus:String
Aliasok:N, Name
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-Context

Megadja azt az Azure Storage-fiókot, amelyből le szeretné kapni a blobok listáját. A New-AzureStorageContext parancsmaggal tárkörnyezetet hozhat létre.

Típus:IStorageContext
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-ContinuationToken

A bloblista folytatási jogkivonatát adja meg. Ezt a paramétert és a MaxCount paramétert használva listázhatja a blobokat több kötegben.

Típus:BlobContinuationToken
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Típus:IAzureContextContainer
Aliasok:AzureRmContext, AzureCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-IncludeDeleted

A törölt blobok belefoglalása alapértelmezés szerint a get blob nem tartalmazza a törölt blobot.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaxCount

Meghatározza a parancsmag által visszaadott objektumok maximális számát.

Típus:Nullable<T>[Int32]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Prefix

Megadja a lekérni kívánt blobnevek előtagjait. Ez a paraméter nem támogatja a reguláris kifejezések vagy helyettesítő karakterek keresését. Ez azt jelenti, hogy ha a tárolóban csak "My", "MyBlob1" és "MyBlob2" nevű blobok vannak, és a "-Prefix My*" értéket adja meg, a parancsmag nem ad vissza blobokat. Ha azonban a "-Prefix My" értéket adja meg, a parancsmag a "My", a "MyBlob1" és a "MyBlob2" értéket adja vissza.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ServerTimeoutPerRequest

A szolgáltatásoldali időtúllépési időközt adja meg másodpercben egy kéréshez. Ha a megadott időköz el nem telik, mielőtt a szolgáltatás feldolgozza a kérést, a tárolási szolgáltatás hibát ad vissza.

Típus:Nullable<T>[Int32]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

String

IStorageContext

Kimenetek

AzureStorageBlob