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

Get-AzStorageBlob

Modul:
Az.Storage Module

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

Syntax

BlobName (Alapértelmezett) 

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>]

SingleBlobSnapshotTime 

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

SingleBlobVersionID 

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

BlobPrefix 

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

Description

A Get-AzStorageBlob 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

Get-AzStorageBlob -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

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

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

Get-AzStorageBlob -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

$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"

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-AzStorageBlob 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.

5. példa: A tárolóban lévő összes blob lekérése blobverzióval

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 *

Ez a parancs lekéri a tárolóban lévő összes blobot, például blobverziót.

6. példa: Egyetlen blobverzió lekérése

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

Ez a parancs egyetlen blobverziót kap a VersionId azonosítóval.

7. példa: Egyetlen blob pillanatképének lekérése

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

Ez a parancs egyetlen blob-pillanatképet kap a SnapshotTime használatával.

8. példa: Blobok lekérése blobcímkék használatával

$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

Ez a parancs blobcímkéket tartalmazó tárolóból származó blobokat sorol fel, és megjeleníti az első blob címkéinek megjelenítését.

9. példa: Egyetlen blob lekérése blobcímkével

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 *

Ez a parancs egyetlen blobot kap blobcímkével. A parancsmag csak akkor lesz sikeres, ha a blob tartalmaz egy "tag1" nevű és "value1" értékű címkét, különben a parancsmag a 412-s hibakóddal hiúsul meg.

10. példa: Egyetlen blob blobtulajdonságainak lekérése (például: ImmutabilityPolicy)

$blobProperties = (Get-AzStorageBlob -Container "ContainerName" -Blob "blob" -Context $ctx).BlobProperties
$blobProperties.ImmutabilityPolicy

ExpiresOn                   PolicyMode
---------                   ----------
9/17/2024 2:49:32 AM +00:00   Unlocked

Ez a példaparancs egyetlen blob nem módosítható tulajdonságát kapja meg. A blobtulajdonságok részletes listáját a BlobProperties tulajdonságból szerezheti be, többek között a következőkre: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy stb. Ha több blobot szeretne listázni (a parancsmagot blobnév nélkül szeretné végrehajtani), használja a ListBlobProperties.Propertiesfüggvényt a BlobProperties helyett a jobb teljesítmény érdekében.

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. Ez a paraméter a karakterlánc bármely pontján támogatja a helyettesítő karaktereket.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

BlobName
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ClientTimeoutPerRequestInSeconds

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Container

Megadja a tároló nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:N, Név

Paraméterkészletek

(All)
Position:1
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Context

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

Paramétertulajdonságok

Típus:IStorageContext
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-DefaultProfile

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

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IncludeDeleted

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IncludeTag

Blobcímkék belefoglalása, a blobok beolvasása alapértelmezés szerint nem tartalmazza a blobcímkéket.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IncludeVersion

A blobverziók csak akkor lesznek felsorolva, ha ez a paraméter jelen van, alapértelmezés szerint a get blob nem tartalmazza a blobverziókat.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

BlobPrefix
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-MaxCount

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

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

BlobPrefix
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:

Nullable<T>[Int32]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:ServerTimeoutPerRequestInSeconds

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SnapshotTime

Blob SnapshotTime

Paramétertulajdonságok

Típus:

Nullable<T>[DateTimeOffset]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

SingleBlobSnapshotTime
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-TagCondition

Nem kötelező címkekifejezési utasítás az egyezés feltételének ellenőrzéséhez. A blobkérés sikertelen lesz, ha a blobcímkék nem felelnek meg a megadott kifejezésnek. Részletek a következőben találhatók: https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

BlobName
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
SingleBlobSnapshotTime
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False
SingleBlobVersionID
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-VersionId

Blob verzióazonosítója

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

SingleBlobVersionID
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

IStorageContext

Kimenetek

AzureStorageBlob