Get-AzStorageBlobByTag

Répertorie les objets blob d’un compte de stockage sur plusieurs conteneurs, avec une expression sql de filtre d’étiquette d’objet 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

L’applet de commande Get-Az Stockage BlobByTag répertorie les objets blob d’un compte de stockage sur plusieurs conteneurs, avec une expression sql de filtre d’étiquette d’objet blob.

Exemples

Exemple 1 : Lister tous les objets blob correspondent à une balise d’objet blob spécifique, entre les conteneurs.

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

Cette commande répertorie tous les objets blob d’un compte de stockage, qui contient une balise portant le nom « tag1 » et la valeur « value1 ».

Exemple 2 : Répertorier les objets blob dans un conteneur spécifique et faire correspondre une balise d’objet blob spécifique

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

Cette commande répertorie les objets blob dans un conteneur et correspond à une balise d’objet blob spécifique.

Exemple 3 : Lister tous les objets blob correspondent à une balise d’objet blob spécifique, entre les conteneurs et obtenir les propriétés de l’objet 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 *

Cette commande répertorie tous les objets blob d’un compte de stockage, qui contient une balise portant le nom « tag1 » et la valeur « value1 », et obtient les propriétés de l’objet blob. Notez que pour obtenir des propriétés d’objet blob avec le paramètre -GetBlobProperty, chaque objet blob aura besoin d’une requête supplémentaire. Par conséquent, l’applet de commande s’exécute lorsqu’il existe de nombreux objets blob.

Paramètres

-ClientTimeoutPerRequest

Durée d’exécution maximale côté client pour chaque requête en secondes.

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

-ConcurrentTaskCount

Quantité totale de tâches asynchrones simultanées. La valeur par défaut est 10.

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

-Container

Nom du conteneur, spécifiez ce paramètre pour renvoyer uniquement tous les objets blob dont les balises correspondent à une expression de recherche dans le conteneur.

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

-Context

objet de contexte Stockage Azure

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

-ContinuationToken

Jeton de continuation.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

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

-GetBlobProperty

À mesure que les objets blob obtiennent par balise ne contiennent pas de proeprties d’objet blob, spécifiez le paramètre tis pour obtenir des propriétés d’objet blob avec une requête supplémentaire sur chaque objet blob.

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

-MaxCount

Nombre maximal d’objets blob pouvant retourner.

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

-ServerTimeoutPerRequest

Délai d’expiration du serveur pour chaque requête en secondes.

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

-TagFilterSqlExpression

Filtre le jeu de résultats pour inclure uniquement les objets blob dont les balises correspondent à l’expression spécifiée. Voir les détails dans 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

Entrées

IStorageContext

Sorties

AzureStorageBlob