Share via

Get-AzStorageFileContent

  • Referens
Modul:
Az.Storage

Laddar ned innehållet i en fil.

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

Cmdleten Get-AzStorageFileContent laddar ned innehållet i en fil och sparar den sedan till ett mål som du anger. Den här cmdleten returnerar inte innehållet i filen.

Exempel

Exempel 1: Ladda ned en fil från en mapp

Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Det här kommandot laddar ned en fil med namnet CurrentDataFile i mappen ContosoWorkingFolder från filresursen ContosoShare06 till den aktuella mappen.

Exempel 2: Laddar ned filerna under exempelfilresursen

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

I det här exemplet laddas filerna ned under exempelfilresursen

Exempel 3: Ladda ned en Azure-fil till en lokal fil och använd egenskaperna för Azure File SMB (Fil-attribut, filskapandetid, fil senaste skrivtid) i den lokala filen.

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

I det här exemplet laddas en Azure-fil ned till en lokal fil och egenskaperna för Azure File SMB (File Attributtes, File Creation Time, File Last Write Time) används i den lokala filen.

Parametrar

-AsJob

Kör cmdleten i bakgrunden.

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

-CheckMd5

Anger om md5-summan ska kontrolleras för den nedladdade filen.

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

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-Context

Anger en Azure Storage-kontext. Om du vill hämta en kontext använder du cmdleten New-AzStorageContext.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Anger målsökvägen. Den här cmdleten laddar ned filinnehållet till den plats som den här parametern anger. Om du anger sökvägen till en fil som inte finns skapar den här cmdleten filen och sparar innehållet i den nya filen. Om du anger en sökväg för en fil som redan finns och du anger force-parametern skriver cmdleten över filen. Om du anger en sökväg för en befintlig fil och du inte anger Tvinga, frågar cmdleten dig innan den fortsätter. Om du anger sökvägen till en mapp försöker den här cmdleten skapa en fil som har namnet på Azure Storage-filen.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Anger en mapp som ett CloudFileDirectory-objekt . Den här cmdleten hämtar innehåll för en fil i mappen som den här parametern anger. Om du vill hämta en katalog använder du cmdleten New-AzStorageDirectory. Du kan också använda cmdleten Get-AzStorageFile för att hämta en katalog.

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

-DisAllowTrailingDot

Tillåt inte avslutande punkt (.) till suffixkatalog och filnamn.

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

-File

Anger en fil som ett CloudFile-objekt . Den här cmdleten hämtar filen som den här parametern anger. Om du vill hämta ett CloudFile-objekt använder du cmdleten Get-AzStorageFile.

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

-Force

Om du anger sökvägen till en fil som inte finns skapar den här cmdleten filen och sparar innehållet i den nya filen. Om du anger en sökväg för en fil som redan finns och du anger force-parametern skriver cmdleten över filen. Om du anger en sökväg för en befintlig fil och du inte anger Tvinga, frågar cmdleten dig innan den fortsätter. Om du anger sökvägen till en mapp försöker den här cmdleten skapa en fil som har namnet på Azure Storage-filen.

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

-PassThru

Anger att den här cmdleten returnerar det AzureStorageFile-objekt som den laddar ned.

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

-Path

Anger sökväg till en fil. Den här cmdleten hämtar innehållet i filen som den här parametern anger. Om filen inte finns returnerar den här cmdleten ett fel.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PreserveSMBAttribute

Behåll SMB-källegenskaperna för filen (fil-attribut, tid för att skapa filer, senaste skrivningstid) i målfilen. Den här parametern är endast tillgänglig i Windows.

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

-ServerTimeoutPerRequest

Anger tidsgränsen för tjänstsidan i sekunder för en begäran. Om det angivna intervallet förflutit innan tjänsten bearbetar begäran returnerar lagringstjänsten ett fel.

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Anger ett CloudFileShare-objekt . Den här cmdleten laddar ned innehållet i filen i den resurs som den här parametern anger. Om du vill hämta ett CloudFileShare-objekt använder du cmdleten Get-AzStorageShare. Det här objektet innehåller lagringskontexten. Om du anger den här parametern ska du inte ange parametern Kontext .

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

-ShareClient

CloudFileShare-objektet angav resursen där filen skulle laddas ned.

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

-ShareDirectoryClient

ShareDirectoryClient-objektet angav molnkatalogen där filen skulle laddas ned.

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

-ShareFileClient

ShareFileClient-objektet angav att molnfilen skulle laddas ned.

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

-ShareName

Anger namnet på filresursen. Den här cmdleten laddar ned innehållet i filen i den resurs som den här parametern anger.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Utdata

AzureStorageFile