Get-AzStorageBlobContent

Module:

Az.Storage Module

Télécharge un objet blob de stockage.

Syntaxe

ReceiveManual (Par défaut)

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

BlobPipeline

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

ContainerPipeline

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

UriPipeline

Get-AzStorageBlobContent
    -AbsoluteUri <String>
    [-Destination <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-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 retourné public et les informations d’identification 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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Uri, BlobUri

Jeux de paramètres

UriPipeline

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-AsJob

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Blob

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ReceiveManual

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

ContainerPipeline

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-BlobBaseClient

Objet BlobBaseClient

Propriétés du paramètre

Type:	BlobBaseClient
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

BlobPipeline

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-CheckMd5

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ReceiveManual

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

BlobPipeline

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

ContainerPipeline

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	ClientTimeoutPerRequestInSeconds

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-CloudBlob

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

Propriétés du paramètre

Type:	Microsoft.Azure.Storage.Blob.CloudBlob
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	ICloudBlob

Jeux de paramètres

BlobPipeline

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Microsoft.Azure.Storage.Blob.CloudBlobContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ContainerPipeline

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Container

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ReceiveManual

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	IStorageContext
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

ReceiveManual

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

BlobPipeline

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

ContainerPipeline

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-DefaultProfile

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

Propriétés du paramètre

Type:	IAzureContextContainer
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	AzureRmContext, AzureCredential

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Destination

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

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Chemin

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Force

Remplace un fichier existant sans confirmation.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	Nullable<T>[Int32]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	ServerTimeoutPerRequestInSeconds

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.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.

Liens associés

• Set-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob