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 FalseCette 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 |