Partager via

Get-AzStorageBlobContent

  • Référence
Module:
Az.Storage

Télécharge un objet blob de stockage.

Syntaxe

Get-AzStorageBlobContent
   [-Blob] <String>
   [-Container] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlob <CloudBlob>
   [-BlobBaseClient <BlobBaseClient>]
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   -CloudBlobContainer <CloudBlobContainer>
   [-Blob] <String>
   [-Destination <String>]
   [-CheckMd5]
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzStorageBlobContent
   [-Destination <String>]
   -AbsoluteUri <String>
   [-Force]
   [-AsJob]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Get-AzStorageBlobContent télécharge l’objet blob de stockage spécifié. Si le nom de l’objet blob n’est pas valide pour l’ordinateur local, cette applet de commande la résout automatiquement si elle est possible.

Exemples

Exemple 1 : Télécharger le contenu d’objet blob par nom

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Cette commande télécharge un objet blob par nom.

Exemple 2 : Télécharger le contenu d’objet blob à l’aide du pipeline

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

Cette commande utilise le pipeline pour rechercher et télécharger du contenu d’objet blob.

Exemple 3 : Télécharger le contenu d’objet blob à l’aide du pipeline et d’un caractère générique

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

Cet exemple utilise le caractère générique astérisque et le pipeline pour rechercher et télécharger du contenu d’objet blob.

Exemple 4 : Obtenir un objet blob et l’enregistrer dans une variable, puis télécharger le contenu de l’objet blob avec l’objet blob

$blob = Get-AzStorageBlob -Container containername -Blob blobname 
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

Cet exemple obtient d’abord un objet blob et l’enregistre dans une variable, puis télécharge le contenu de l’objet blob avec l’objet blob.

Exemple 5 : Télécharger un contenu d’objet blob avec l’URI d’objet blob

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

Cet exemple télécharge un contenu d’objet blob avec Uri, l’URI peut être un URI avec un jeton Sas. Si l’objet blob se trouve sur un compte de disque managé et que le serveur nécessite un jeton du porteur en plus de l’URI Sas à télécharger, l’applet de commande tente de générer un jeton du porteur avec le serveur renvoyé public et le fichier de credentail de l’utilisateur AAD de connexion, puis téléchargez l’objet blob avec l’URI Sas et le jeton du porteur.

Paramètres

-AbsoluteUri

URI d’objet blob à télécharger à partir de.

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

-AsJob

Exécutez l’applet de commande en arrière-plan.

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

-Blob

Spécifie le nom de l’objet blob à télécharger.

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

-BlobBaseClient

Objet BlobBaseClient

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

-CheckMd5

Spécifie s’il faut vérifier la somme Md5 pour le fichier téléchargé.

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

-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]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CloudBlob

Spécifie un objet blob cloud. Pour obtenir un objet CloudBlob , utilisez l’applet de commande Get-AzStorageBlob.

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

-CloudBlobContainer

Spécifie un objet CloudBlobContainer à partir de la bibliothèque cliente stockage Azure. Vous pouvez le créer ou utiliser l’applet de commande Get-AzStorageContainer.

Type:CloudBlobContainer
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

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

-Container

Spécifie le nom du conteneur avec l’objet blob que vous souhaitez télécharger.

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

-Context

Spécifie le compte de stockage Azure à partir duquel vous souhaitez télécharger le contenu de l’objet blob. Vous pouvez utiliser l’applet de commande New-AzStorageContext 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

-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

-Destination

Spécifie l’emplacement pour stocker le fichier téléchargé.

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

-Force

Remplace un fichier existant sans confirmation.

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

-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]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TagCondition

Instruction d’expression tag facultative pour vérifier la condition de correspondance. La demande d’objet blob échoue lorsque les balises d’objet blob ne correspondent pas à l’expression donnée. Voir les détails dans https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

CloudBlob

CloudBlobContainer

IStorageContext

Sorties

AzureStorageBlob

Notes

  • Si le nom de l’objet blob n’est pas valide pour l’ordinateur local, cette applet de commande la résoudre automatiquement, si elle est possible.