Partager via

Get-AzStorageFileContent

  • Référence
Module:
Az.Storage

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

Syntaxe

Get-AzStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-DisAllowTrailingDot]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-ShareClient <ShareClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-ShareDirectoryClient <ShareDirectoryClient>]
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]
Get-AzStorageFileContent
   [-File] <CloudFile>
   [-ShareFileClient <ShareFileClient>]
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Description

L’applet de commande Get-AzStorageFileContent 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

Get-AzStorageFileContent -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écharge les fichiers sous l’exemple de partage de fichiers

Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContent

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

Exemple 3 : Téléchargez un fichier Azure dans un fichier local et perservez les propriétés Azure File SMB (Attributs de fichier, Heure de création de fichier, Heure de dernière écriture) dans le fichier local.

Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

Cet exemple télécharge un fichier Azure dans un fichier local et perserve les propriétés Azure File SMB (Attributs de fichier, Heure de création de fichier, Heure de dernière écriture) dans le fichier local.

Paramètres

-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

-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

-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

-Context

Spécifie un contexte Stockage Azure. Pour obtenir un contexte, utilisez l’applet de commande New-AzStorageContext.

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-AzStorageDirectory. Vous pouvez également utiliser l’applet de commande Get-AzStorageFile pour obtenir un répertoire.

Type:CloudFileDirectory
Alias: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

-DisAllowTrailingDot

Interdire le point de fin (.) au répertoire de suffixe et aux noms de fichiers.

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

-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-AzStorageFile.

Type:CloudFile
Alias: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

Indique que cette applet de commande retourne l’objet AzureStorageFile qu’il télécharge.

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

-PreserveSMBAttribute

Conservez les propriétés SMB du fichier source (Attributs de fichier, Heure de création de fichier, Heure de la dernière écriture du fichier) dans le fichier de destination. Ce paramètre est disponible uniquement sur Windows.

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

-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-AzStorageShare. Cet objet contient le contexte de stockage. Si vous spécifiez ce paramètre, ne spécifiez pas le paramètre Context .

Type:CloudFileShare
Alias: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

-ShareClient

L’objet CloudFileShare indique le partage dans lequel le fichier serait téléchargé.

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

-ShareDirectoryClient

L’objet ShareDirectoryClient indique le répertoire cloud dans lequel le fichier serait téléchargé.

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

-ShareFileClient

L’objet ShareFileClient indique le fichier cloud à télécharger.

Type:ShareFileClient
Position:Named
Valeur par défaut:None
Obligatoire:False
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

CloudFileDirectory

CloudFile

IStorageContext

Sorties

AzureStorageFile