Share via


Get-AzStorageFileContent

Letölti egy fájl tartalmát.

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

A Get-AzStorageFileContent parancsmag letölti egy fájl tartalmát, majd menti egy megadott helyre. Ez a parancsmag nem adja vissza a fájl tartalmát.

Példák

1. példa: Fájl letöltése mappából

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

Ez a parancs letölt egy CurrentDataFile nevű fájlt a ContosoWorkingFolder mappába a ContosoShare06 fájlmegosztásból az aktuális mappába.

2. példa: A fájlok letöltése a mintafájlmegosztás alatt

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

Ez a példa letölti a fájlokat a mintafájlmegosztás alatt

3. példa: Töltsön le egy Azure-fájlt egy helyi fájlba, és tartsa meg a helyi fájlBan az Azure File SMB-tulajdonságait (fájltulajdonságok, fájllétrehozási idő, fájl utolsó írási ideje).

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

Ez a példa letölt egy Azure-fájlt egy helyi fájlba, és fenntartja az Azure File SMB-tulajdonságait (fájl-hozzárendelések, fájllétrehozási idő, fájl utolsó írási ideje) a helyi fájlban.

Paraméterek

-AsJob

Futtassa a parancsmagot a háttérben.

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

-CheckMd5

Megadja, hogy ellenőrizze-e a letöltött fájl Md5-összegét.

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

-ClientTimeoutPerRequest

Egy szolgáltatáskérés ügyféloldali időtúllépési időközét adja meg másodpercben. Ha az előző hívás a megadott időközönként meghiúsul, a parancsmag újrapróbálkozza a kérést. Ha ez a parancsmag nem kap sikeres választ az időköz eltelte előtt, ez a parancsmag hibát ad vissza.

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

-ConcurrentTaskCount

Az egyidejű hálózati hívások maximális száma. Ezzel a paramétersel korlátozhatja az egyidejűséget a helyi processzor- és sávszélesség-használat szabályozására az egyidejű hálózati hívások maximális számának megadásával. A megadott érték abszolút szám, és nem szorozza meg a magok számával. Ez a paraméter segíthet csökkenteni a hálózati csatlakozási problémákat alacsony sávszélességű környezetekben, például másodpercenként 100 kilobitben. Az alapértelmezett érték 10.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Context

Egy Azure Storage-környezetet határoz meg. Környezet beszerzéséhez használja a New-AzStorageContext parancsmagot.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

-Destination

Megadja a cél elérési útját. Ez a parancsmag letölti a fájl tartalmát a paraméter által megadott helyre. Ha egy nem létező fájl elérési útját adja meg, ez a parancsmag létrehozza a fájlt, és menti a tartalmat az új fájlba. Ha egy már létező fájl elérési útját adja meg, és megadja a Force paramétert, a parancsmag felülírja a fájlt. Ha egy meglévő fájl elérési útját adja meg, és nem adja meg a Force parancsmagot, a parancsmag a folytatás előtt kéri. Ha megadja egy mappa elérési útját, ez a parancsmag megpróbál létrehozni egy olyan fájlt, amely az Azure Storage-fájl nevét tartalmazza.

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

-Directory

Egy mappát CloudFileDirectory objektumként határoz meg. Ez a parancsmag lekéri a paraméter által megadott mappában lévő fájl tartalmát. Könyvtár beszerzéséhez használja a New-AzStorageDirectory parancsmagot. A Get-AzStorageFile parancsmaggal is beszerezhet egy könyvtárat.

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

-DisAllowTrailingDot

Tiltsa le a záró pont (.) használatát az utótagkönyvtárakra és a fájlnevekre.

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

-File

Egy fájlt CloudFile-objektumként határoz meg. Ez a parancsmag lekéri a paraméter által megadott fájlt. CloudFile-objektum beszerzéséhez használja a Get-AzStorageFile parancsmagot.

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

-Force

Ha egy nem létező fájl elérési útját adja meg, ez a parancsmag létrehozza a fájlt, és menti a tartalmat az új fájlba. Ha egy már létező fájl elérési útját adja meg, és megadja a Force paramétert, a parancsmag felülírja a fájlt. Ha egy meglévő fájl elérési útját adja meg, és nem adja meg a Force parancsmagot, a parancsmag a folytatás előtt kéri. Ha megadja egy mappa elérési útját, ez a parancsmag megpróbál létrehozni egy olyan fájlt, amely az Azure Storage-fájl nevét tartalmazza.

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

-PassThru

Azt jelzi, hogy ez a parancsmag a letöltött AzureStorageFile objektumot adja vissza.

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

-Path

Megadja a fájl elérési útját. Ez a parancsmag lekéri a paraméter által megadott fájlt. Ha a fájl nem létezik, ez a parancsmag hibát ad vissza.

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

-PreserveSMBAttribute

Tartsa meg a forrásfájl SMB-tulajdonságait (fájltulajdonságok, fájllétrehozási idő, fájl utolsó írási ideje) a célfájlban. Ez a paraméter csak Windows rendszeren érhető el.

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

-ServerTimeoutPerRequest

A szolgáltatásoldali időtúllépési időközt adja meg másodpercben egy kéréshez. Ha a megadott időköz el nem telik, mielőtt a szolgáltatás feldolgozza a kérést, a tárolási szolgáltatás hibát ad vissza.

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

-Share

CloudFileShare objektumot ad meg. Ez a parancsmag letölti a fájl tartalmát a paraméter által megadott megosztásban. CloudFileShare-objektum beszerzéséhez használja a Get-AzStorageShare parancsmagot. Ez az objektum tartalmazza a tárolási környezetet. Ha ezt a paramétert adja meg, ne adja meg a Környezeti paramétert.

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

-ShareClient

A CloudFileShare objektum azt a megosztást jelölte meg, ahová a fájl letöltődik.

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

-ShareDirectoryClient

A ShareDirectoryClient objektum azt a felhőkönyvtárat jelölte meg, ahová a fájl letöltődik.

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

-ShareFileClient

A ShareFileClient objektum a letölteni kívánt felhőfájlt jelölte meg.

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

-ShareName

Megadja a fájlmegosztás nevét. Ez a parancsmag letölti a fájl tartalmát a paraméter által megadott megosztásban.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Kimenetek

AzureStorageFile