Compartir a través de


Get-AzStorageBlobByTag

Enumera los blobs de una cuenta de almacenamiento entre contenedores, con una expresión sql de filtro de etiqueta de blob.

Sintaxis

Default (valor predeterminado)

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.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ConcurrentTaskCount

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

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Context

Objeto de contexto de Azure Storage

Propiedades de parámetro

Tipo:IStorageContext
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ContinuationToken

Token de continuación.

Propiedades de parámetro

Tipo:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

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

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GetBlobProperty

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaxCount

Recuento máximo de los blobs que pueden devolver.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServerTimeoutPerRequest

Tiempo de espera del servidor para cada solicitud en segundos.

Propiedades de parámetro

Tipo:

Nullable<T>[Int32]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TagFilterSqlExpression

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

IStorageContext

Salidas

AzureStorageBlob