Get-AzStorageBlobByTag

Reference

Modul:: Az.Storage

Vypíše objekty blob v účtu úložiště napříč kontejnery s výrazem SQL filtru značek objektů blob.

Syntax

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

Description

Rutina Get-AzStorageBlobByTag vypíše objekty blob v účtu úložiště napříč kontejnery s výrazem SQL filtru značek objektů blob.

Příklady

Příklad 1: Výpis všech objektů blob odpovídá konkrétní značce objektu blob napříč kontejnery.

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

Tento příkaz zobrazí seznam všech objektů blob v účtu úložiště, který obsahuje značku s názvem "tag1" a hodnotou "value1".

Příklad 2: Výpis objektů blob v konkrétním kontejneru a shoda s konkrétní značkou objektu blob

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

Tento příkaz zobrazí seznam objektů blob v kontejneru a odpovídá konkrétní značce objektu blob.

Příklad 3: Výpis všech objektů blob odpovídá konkrétní značce objektu blob napříč kontejnery a získání vlastností objektu blob.

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 *

Tento příkaz zobrazí seznam všech objektů blob v účtu úložiště, který obsahuje značku s názvem "tag1" a hodnotu "value1", a získá vlastnosti objektu blob. Upozorňujeme, že pokud chcete získat vlastnosti objektu blob s parametrem -GetBlobProperty, každý objekt blob bude potřebovat další požadavek, takže rutina se spustí, když existuje mnoho objektů blob.

Parametry

-ClientTimeoutPerRequest

Maximální doba provádění na straně klienta pro každý požadavek v sekundách.

Typ:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConcurrentTaskCount

Celkový počet souběžných asynchronních úloh. Výchozí hodnota je 10.

Typ:	Nullable<T>[Int32]
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Container

Název kontejneru, zadejte tento parametr tak, aby vracely pouze všechny objekty blob, jejichž značky odpovídají hledanému výrazu v kontejneru.

Typ:	String
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Kontextový objekt služby Azure Storage

Typ:	IStorageContext
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ContinuationToken

Token pokračování

Typ:	BlobContinuationToken
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GetBlobProperty

Vzhledem k tomu, že objekty blob na základě značky neobsahují proeprties objektu blob, zadejte parametr tis pro získání vlastností objektu blob s dalším požadavkem na každý objekt blob.

Typ:	SwitchParameter
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxCount

Maximální počet objektů blob, které se můžou vrátit.

Typ:	Nullable<T>[Int32]
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerTimeoutPerRequest

Časový limit serveru pro každý požadavek v sekundách vypršel.

Typ:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Position:	Named
výchozí hodnota:	None
Vyžadováno:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TagFilterSqlExpression

Filtruje sadu výsledků tak, aby zahrnovala pouze objekty blob, jejichž značky odpovídají zadanému výrazu. Podívejte se na podrobnosti na stránce https://learn.microsoft.com/en-us/rest/api/storageservices/find-blobs-by-tags#remarks.

Typ:	String
Position:	Named
výchozí hodnota:	None
Vyžadováno:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

IStorageContext

Výstupy

AzureStorageBlob

Sdílet prostřednictvím