Get-AzStorageBlobByTag

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

Syntax

Default (Výchozí)

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.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ClientTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ConcurrentTaskCount

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

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Context

kontextový objekt Azure Storage

Vlastnosti parametru

Typ:IStorageContext
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ContinuationToken

Token pokračování

Vlastnosti parametru

Typ:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

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

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-GetBlobProperty

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxCount

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

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ServerTimeoutPerRequest

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

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:ServerTimeoutPerRequestInSeconds

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

IStorageContext

Výstupy

AzureStorageBlob