Get-AzureStorageBlob

Répertorie les objets blob inclus dans un conteneur.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Get-AzureStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureStorageBlob répertorie les objets blob dans le conteneur spécifié dans un compte de stockage Azure.

Exemples

Exemple 1 : Obtenir un objet blob par nom d’objet blob

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

Cette commande utilise un nom d’objet blob et un caractère générique pour obtenir un objet blob.

Exemple 2 : Obtenir des objets blob dans un conteneur à l’aide du pipeline

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob -IncludeDeleted

   Container Uri: https://storageaccountname.blob.core.windows.net/container1

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime         IsDeleted 
----                 --------  ------          -----------                    ------------         ---------- ------------         --------- 
test1                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:19Z            2017-11-08 08:19:32Z True      
test1                BlockBlob 403116          application/octet-stream       2017-11-08 09:00:29Z                                 True      
test2                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:00Z                                 False

Cette commande utilise le pipeline pour obtenir tous les objets blob (inclure des objets blob dans l’état supprimé) dans un conteneur.

Exemple 3 : Obtenir des objets blob par préfixe de nom

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Prefix "blob"

Cette commande utilise un préfixe de nom pour obtenir des objets blob.

Exemple 4 : Répertorier les objets blob dans plusieurs lots

PS C:\>$MaxReturn = 10000
PS C:\> $ContainerName = "abc"
PS C:\> $Total = 0
PS C:\> $Token = $Null
PS C:\> do
 {
     $Blobs = Get-AzureStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($Token -ne $Null)
PS C:\> Echo "Total $Total blobs in container $ContainerName"

Cet exemple utilise les paramètres MaxCount et ContinuationToken pour répertorier les objets blob Stockage Azure dans plusieurs lots. Les quatre premières commandes attribuent des valeurs à des variables à utiliser dans l’exemple. La cinquième commande spécifie une instruction Do-While qui utilise l’applet de commande Get-AzureStorageBlob pour obtenir des objets blob. L’instruction inclut le jeton de continuation stocké dans la variable $Token. $Token modifie la valeur lors de l’exécution de la boucle. Pour plus d'informations, voir Get-Help About_Do. La commande finale utilise la commande Echo pour afficher le total.

Paramètres

-Blob

Spécifie un nom ou un modèle de nom, qui peut être utilisé pour une recherche générique. Si aucun nom d’objet blob n’est spécifié, l’applet de commande répertorie tous les objets blob du conteneur spécifié. Si une valeur est spécifiée pour ce paramètre, l’applet de commande répertorie tous les objets blob avec des noms correspondant à ce paramètre.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientTimeoutPerRequest

Spécifie l’intervalle de délai d’attente côté client, en secondes, pour une demande de service. Si l’appel précédent échoue dans l’intervalle spécifié, cette applet de commande retente la requête. Si cette applet de commande ne reçoit pas de réponse réussie avant l’expiration de l’intervalle, cette applet de commande retourne une erreur.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConcurrentTaskCount

Spécifie le nombre maximal d’appels réseau simultanés. Vous pouvez utiliser ce paramètre pour limiter l’accès concurrentiel pour limiter l’utilisation du processeur local et de la bande passante en spécifiant le nombre maximal d’appels réseau simultanés. La valeur spécifiée est un nombre absolu et n’est pas multipliée par le nombre de cœurs. Ce paramètre peut aider à réduire les problèmes de connexion réseau dans des environnements à faible bande passante, tels que 100 kilobits par seconde. La valeur par défaut est 10.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Container

Spécifie le nom du conteneur.

Type:String
Alias:N, Name
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Context

Spécifie le compte de stockage Azure à partir duquel vous souhaitez obtenir la liste des objets blob. Vous pouvez utiliser l’applet de commande New-AzureStorageContext pour créer un contexte de stockage.

Type:IStorageContext
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ContinuationToken

Spécifie un jeton de continuation pour la liste d’objets blob. Utilisez ce paramètre et le paramètre MaxCount pour répertorier les objets blob dans plusieurs lots.

Type:BlobContinuationToken
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

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

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IncludeDeleted

Inclure l’objet blob supprimé, par défaut get blob n’inclut pas l’objet blob supprimé.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxCount

Spécifie le nombre maximal d’objets retournés par cette applet de commande.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Prefix

Spécifie un préfixe pour les noms d’objets blob que vous souhaitez obtenir. Ce paramètre ne prend pas en charge l’utilisation d’expressions régulières ou de caractères génériques à rechercher. Cela signifie que si le conteneur a uniquement des objets blob nommés « My », « MyBlob1 » et « MyBlob2 » et que vous spécifiez « -Prefix My* », l’applet de commande ne renvoie aucun objet blob. Toutefois, si vous spécifiez « -Prefix My », l’applet de commande renvoie « My », « MyBlob1 » et « MyBlob2 ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServerTimeoutPerRequest

Spécifie l’intervalle de délai d’expiration côté service, en secondes, pour une demande. Si l’intervalle spécifié s’écoule avant que le service traite la requête, le service de stockage retourne une erreur.

Type:Nullable<T>[Int32]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

IStorageContext

Sorties

AzureStorageBlob