Get-AzStorageBlobByTag

Egy tárfiókban lévő blobok listája tárolók között, egy blobcímkeszűrő sql-kifejezéssel.

Syntax

Default (Alapértelmezett)

Get-AzStorageBlobByTag
    -TagFilterSqlExpression <String>
    [-MaxCount <Int32>]
    [-ContinuationToken <BlobContinuationToken>]
    [-GetBlobProperty]
    [-Container <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [<CommonParameters>]

Description

A Get-AzStorageBlobByTag parancsmag a tárolók közötti tárfiókban lévő blobokat sorolja fel egy blobcímkeszűrő SQL-kifejezéssel.

Példák

1. példa: Az összes blob listázása egy adott blobcímkének felel meg a tárolók között.

Get-AzStorageBlobByTag -TagFilterSqlExpression """tag1""='value1'" -Context $ctx
AccountName: storageaccountname, ContainerName: containername1

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------
testblob                                                                                                                                   False
testblob2                                                                                                                                  False

   AccountName: storageaccountname, ContainerName: containername2

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------
testblob3                                                                                                                                   False
testblob4                                                                                                                                   False

Ez a parancs felsorolja a tárfiókban lévő összes blobot, amely egy "tag1" és "value1" nevű címkét tartalmaz.

2. példa: Blobok listázása egy adott tárolóban, és megfelel egy adott blobcímkének

Get-AzStorageBlobByTag -Container 'containername' -TagFilterSqlExpression """tag1""='value1'" -Context $ctx
AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------
test1                                                                                                                                      False
test2                                                                                                                                      False

Ez a parancs felsorolja a tárolóban lévő blobokat, és megfelel egy adott blobcímkének.

3. példa: Az összes blob listázása egy adott blobcímkével, tárolók között, és a blobtulajdonságok lekérése.

Get-AzStorageBlobByTag -TagFilterSqlExpression """tag1""='value1'" -GetBlobProperty
AccountName: storageaccountname, ContainerName: containername1

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 1048012         application/octet-stream       2020-07-23 09:35:05Z Hot                                     False      2020-07-23T09:35:05.2504530Z *

   AccountName: storageaccountname, ContainerName: containername2

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------
testblob3            BlockBlob 100             application/octet-stream       2020-07-01 09:55:14Z Hot                                     False      2020-07-01T09:55:14.6507341Z *
testblob4            BlockBlob 2024            application/octet-stream       2020-07-01 09:42:11Z Hot                                     False      2020-07-01T09:42:11.4283807Z *

Ez a parancs felsorolja a tárfiókban lévő összes blobot, amely egy "tag1" nevű és "érték1" értékű címkét tartalmaz, és lekéri a blob tulajdonságait. Vegye figyelembe, hogy ha a -GetBlobProperty paraméterrel szeretné lekérni a blobtulajdonságokat, minden blobnak további kérésre lesz szüksége, így a parancsmagok akkor jelennek meg, ha sok blob van.

Paraméterek

-ClientTimeoutPerRequest

Az ügyféloldali maximális végrehajtási idő az egyes kérésekhez másodpercben.

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ű aszinkron tevékenységek teljes mennyisége. 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

Tárolónév, adja meg ezt a paramétert, hogy csak az összes olyan blobot adja vissza, amelynek címkéi megegyeznek a tároló keresési kifejezésével.

Paramétertulajdonságok

Típus:String
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

-Context

Azure Storage környezeti objektum

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

Folytatási jogkivonat.

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

-GetBlobProperty

Mivel a címkék által lekért blobok nem tartalmaznak blobtulajdonságokat, adja meg a tis paramétert a blobtulajdonságok lekéréséhez egy további kéréssel minden blobra vonatkozóan.

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

-MaxCount

A visszaadható blobok maximális száma.

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

-ServerTimeoutPerRequest

A kiszolgáló másodpercek alatt időtúllépést hajt végre az egyes kérések esetében.

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

-TagFilterSqlExpression

Az eredményhalmazt úgy szűri, hogy csak olyan blobokat tartalmazzon, amelyek címkéi megegyeznek a megadott kifejezéssel. Részletek a következőben találhatók: https://learn.microsoft.com/en-us/rest/api/storageservices/find-blobs-by-tags#remarks.

Paramétertulajdonságok

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

Paraméterkészletek

(All)
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

IStorageContext

Kimenetek

AzureStorageBlob