Get-AzStorageFileContent

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

Syntax

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-Az Stockage FileContent 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 S Mo (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 S Mo (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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckMd5

Spécifie s’il faut case activée la somme Md5 pour le fichier téléchargé.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

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

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-Az Stockage Directory. Vous pouvez également utiliser l’applet de commande Get-Az Stockage File pour obtenir un répertoire.

Type:CloudFileDirectory
Aliases:CloudFileDirectory
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DisAllowTrailingDot

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-Az Stockage File.

Type:CloudFile
Aliases:CloudFile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PreserveSMBAttribute

Conservez les propriétés du fichier source S Mo (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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-Az Stockage Share. Cet objet contient le contexte de stockage. Si vous spécifiez ce paramètre, ne spécifiez pas le paramètre Context .

Type:CloudFileShare
Aliases:CloudFileShare
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareClient

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

Type:ShareClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareDirectoryClient

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

Type:ShareDirectoryClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ShareFileClient

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

Type:ShareFileClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Sorties

AzureStorageFile