Partager via

Get-AzureStorageFileContent

  • Référence
Module:
Azure.Storage

Télécharge le contenu d’un fichier.

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-AzureStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Get-AzureStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Get-AzureStorageFileContent télécharge le contenu d’un fichier, puis l’enregistre dans une destination que vous spécifiez. Cette applet de commande ne retourne pas le contenu du fichier.

Exemples

Exemple 1 : Télécharger un fichier à partir d’un dossier

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Cette commande télécharge un fichier nommé CurrentDataFile dans le dossier ContosoWorkingFolder à partir du partage de fichiers ContosoShare06 vers le dossier actif.

Exemple 2 : Télécharger les fichiers sous l’exemple de partage de fichiers

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

Cet exemple télécharge les fichiers sous l’exemple de partage de fichiers

Paramètres

-CheckMd5

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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 l’applet de commande.

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

-Context

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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 le chemin d’accès de destination. Cette applet de commande télécharge le contenu du fichier à l’emplacement spécifié par ce paramètre. Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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

-Directory

Spécifie un dossier en tant qu’objet CloudFileDirectory . Cette applet de commande obtient le contenu d’un fichier dans le dossier spécifié par ce paramètre. Pour obtenir un répertoire, utilisez l’applet de commande New-AzureStorageDirectory. Vous pouvez également utiliser l’applet de commande Get-AzureStorageFile pour obtenir un répertoire.

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

-File

Spécifie un fichier en tant qu’objet CloudFile . Cette applet de commande obtient le fichier spécifié par ce paramètre. Pour obtenir un objet CloudFile , utilisez l’applet de commande Get-AzureStorageFile.

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

-Force

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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

-PassThru

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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

-Path

Spécifie le chemin d’accès d’un fichier. Cette applet de commande obtient le contenu du fichier spécifié par ce paramètre. Si le fichier n’existe pas, cette applet de commande retourne une erreur.

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

-ServerTimeoutPerRequest

Si vous spécifiez le chemin d’accès d’un fichier qui n’existe pas, cette applet de commande crée ce fichier et enregistre le contenu dans le nouveau fichier. Si vous spécifiez un chemin d’accès d’un fichier qui existe déjà et que vous spécifiez le paramètre Force , l’applet de commande remplace le fichier. Si vous spécifiez un chemin d’accès d’un fichier existant et que vous ne spécifiez pas Force, l’applet de commande vous invite avant de continuer. Si vous spécifiez le chemin d’accès d’un dossier, cette applet de commande tente de créer un fichier portant le nom du fichier de stockage Azure.

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

-Share

Spécifie un objet CloudFileShare . Cette applet de commande télécharge le contenu du fichier dans le partage spécifié par ce paramètre. Pour obtenir un objet CloudFileShare , utilisez l’applet de commande Get-AzureStorageShare. Cet objet contient le contexte de stockage. Si vous spécifiez ce paramètre, ne spécifiez pas le paramètre Context .

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

-ShareName

Spécifie le nom du partage de fichiers. Cette applet de commande télécharge le contenu du fichier dans le partage spécifié par ce paramètre.

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

-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

CloudFileShare

Paramètres : Partager (ByValue)

CloudFileDirectory

Paramètres : Répertoire (ByValue)

CloudFile

Paramètres : Fichier (ByValue)

IStorageContext

Sorties

CloudFile