Get-AzStorageBlobByTag

  • Referencia
Módulo:
Az.Storage

Enumera los blobs de una cuenta de almacenamiento entre contenedores, con una expresión sql de filtro de etiqueta de 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

El cmdlet Get-AzStorageBlobByTag enumera los blobs de una cuenta de almacenamiento entre contenedores, con una expresión sql de filtro de etiqueta de blob.

Ejemplos

Ejemplo 1: Enumere todos los blobs que coincidan con una etiqueta de blob específica, entre contenedores.

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

Este comando enumera todos los blobs de una cuenta de almacenamiento, que contiene una etiqueta con el nombre "tag1" y el valor "value1".

Ejemplo 2: Enumeración de blobs en un contenedor específico y coincidencia con una etiqueta de blob específica

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

Este comando enumera los blobs de un contenedor y coincide con una etiqueta de blob específica.

Ejemplo 3: Enumere todos los blobs que coincidan con una etiqueta de blob específica, entre contenedores y obtenga las propiedades del 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 *

Este comando enumera todos los blobs de una cuenta de almacenamiento, que contiene una etiqueta con el nombre "tag1" y el valor "value1" y obtiene las propiedades del blob. Tenga en cuenta que para obtener propiedades de blob con el parámetro -GetBlobProperty, cada blob necesitará una solicitud adicional, por lo que el cmdlet se ejecuta se muestra cuando hay muchos blobs.

Parámetros

-ClientTimeoutPerRequest

Tiempo máximo de ejecución del lado cliente para cada solicitud en segundos.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Cantidad total de tareas asincrónicas simultáneas. El valor predeterminado es 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Nombre del contenedor, especifique este parámetro para devolver solo todos los blobs cuyas etiquetas coinciden con una expresión de búsqueda en el contenedor.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Objeto de contexto de Azure Storage

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Token de continuación.

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GetBlobProperty

A medida que las etiquetas get by blobs no contienen proeprties de blobs, especifique el parámetro tis para obtener propiedades de blob con una solicitud adicional en cada blob.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

Recuento máximo de los blobs que pueden devolver.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Tiempo de espera del servidor para cada solicitud en segundos.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TagFilterSqlExpression

Filtra el conjunto de resultados para incluir solo blobs cuyas etiquetas coinciden con la expresión especificada. Consulte los detalles en https://learn.microsoft.com/en-us/rest/api/storageservices/find-blobs-by-tags#remarks.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

IStorageContext

Salidas

AzureStorageBlob