Get-AzStorageBlobByTag
Listet Blobs in einem Speicherkonto über Container hinweg auf, wobei ein SQL-Ausdruck für Blobtagfilter vorhanden ist.
Syntax
Default (Standard)
Get-AzStorageBlobByTag
-TagFilterSqlExpression <String>
[-MaxCount <Int32>]
[-ContinuationToken <BlobContinuationToken>]
[-GetBlobProperty]
[-Container <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[<CommonParameters>]
Beschreibung
Das Cmdlet "Get-AzStorageBlobByTag " listet Blobs in einem Speicherkonto in Containern mit einem BLOB-Tag-Filter-SQL-Ausdruck auf.
Beispiele
Beispiel 1: Alle Blobs entsprechen einem bestimmten Blobtag über Container hinweg.
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
Dieser Befehl listet alle Blobs in einem Speicherkonto auf, die ein Tag mit dem Namen "tag1" und dem Wert "value1" enthalten.
Beispiel 2: Auflisten von Blobs in einem bestimmten Container und Übereinstimmung mit einem bestimmten BLOB-Tag
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
Dieser Befehl listet Blobs in einem Container auf und entspricht einem bestimmten BLOB-Tag.
Beispiel 3: Alle Blobs entsprechen einem bestimmten BLOB-Tag, containerübergreifend und rufen die BLOB-Eigenschaften ab.
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 *
Dieser Befehl listet alle Blobs in einem Speicherkonto auf, die ein Tag mit dem Namen "tag1" und dem Wert "value1" enthalten und die BLOB-Eigenschaften abrufen.
Beachten Sie, dass für das Abrufen von BLOB-Eigenschaften mit parameter -GetBlobProperty jedes Blob eine zusätzliche Anforderung benötigt, sodass das Cmdlet ausgeführt wird, wenn viele Blobs vorhanden sind.
Parameter
-ClientTimeoutPerRequest
Die clientseitige maximale Ausführungszeit für jede Anforderung in Sekunden.
Parametereigenschaften
Typ: Nullable<T> [ Int32 ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: ClientTimeoutPerRequestInSeconds
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ConcurrentTaskCount
Die Gesamtmenge der gleichzeitigen asynchronen Vorgänge.
Der Standardwert ist 10.
Parametereigenschaften
Typ: Nullable<T> [ Int32 ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Container
Containername, geben Sie diesen Parameter an, um nur alle Blobs zurückzugeben, deren Tags einem Suchausdruck im Container entsprechen.
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-Context
Azure Storage Context-Objekt
Parametereigenschaften
Typ: IStorageContext
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: True Wert aus Pipeline nach dem Eigenschaftsnamen: True Wert aus verbleibenden Argumenten: False
-ContinuationToken
Fortsetzungstoken.
Parametereigenschaften
Typ: Microsoft.Azure.Storage.Blob.BlobContinuationToken
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-GetBlobProperty
Wenn die Blobs, die vom Tag abgerufen werden, keine BLOB-Eigenschaften enthalten, geben Sie den tis-Parameter an, um BLOB-Eigenschaften mit einer zusätzlichen Anforderung für jedes Blob abzurufen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-MaxCount
Die maximale Anzahl der Blobs, die zurückgegeben werden können.
Parametereigenschaften
Typ: Nullable<T> [ Int32 ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-ServerTimeoutPerRequest
Der Servertimeout für jede Anforderung in Sekunden.
Parametereigenschaften
Typ: Nullable<T> [ Int32 ]
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False Aliase: ServerTimeoutPerRequestInSeconds
Parametersätze
(All)
Position: Named Obligatorisch: False Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
-TagFilterSqlExpression
Filtert das Resultset so, dass nur Blobs enthalten sind, deren Tags dem angegebenen Ausdruck entsprechen.
Weitere Informationen finden Sie unter .
Parametereigenschaften
Typ: String
Standardwert: None Unterstützt Platzhalter: False Nicht anzeigen: False
Parametersätze
(All)
Position: Named Obligatorisch: True Wert aus Pipeline: False Wert aus Pipeline nach dem Eigenschaftsnamen: False Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben