Get-AzStorageBlob

Referencia

Modul:: Az.Storage

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

Syntax

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

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 ContinuationToken paramétereket használja az Azure Storage-blobok több kötegben való listázásához. 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ó: 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 blob-veriont 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 blob prTooperties részletes listáját a BlobProperties tulajdonságból szerezheti be, beleértve, de nem kizárólagosan: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy stb. Ha több blobot szeretne listázni (a parancsmagot blobnév nélkül hajtja végre), a jobb teljesítmény érdekében használja ListBlobProperties.PropertiesBlobProperties helyett.

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.

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

-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]
Aliasok:	ClientTimeoutPerRequestInSeconds
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-AzStorageContext 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

-IncludeTag

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

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]
Aliasok:	ServerTimeoutPerRequestInSeconds
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SnapshotTime

Blob SnapshotTime

Típus:	Nullable<T>[DateTimeOffset]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-VersionId

Blob verzióazonosítója

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

Bevitelek

String

IStorageContext

Kimenetek

AzureStorageBlob

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

Get-AzStorageBlob

Syntax

Description

Példák

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

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

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

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

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

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

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

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

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

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

Paraméterek

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Bevitelek

Kimenetek

További források

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

Get-AzStorageBlob

Syntax

Description

Példák

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

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

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

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

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

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

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

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

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

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

Paraméterek

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Bevitelek

Kimenetek

Kapcsolódó hivatkozások

További források