Get-AzStorageFileContent

Referencia

Modul:: Az.Storage

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
   [-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
   [-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
   [-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 "AzureStorageFile"} | 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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-CheckMd5

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Nullable<T>[Int32]
Aliasok:	ClientTimeoutPerRequestInSeconds
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Nullable<T>[Int32]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Context

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

Típus:	IStorageContext
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-DefaultProfile

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

Típus:	IAzureContextContainer
Aliasok:	AzureRmContext, AzureCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 Kényszerítés, 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.

Típus:	String
Position:	2
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DisAllowTrailingDot

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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 Kényszerítés, 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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PassThru

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Path

Egy fájl elérési útját adja meg. 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.

Típus:	String
Position:	1
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	Nullable<T>[Int32]
Aliasok:	ServerTimeoutPerRequestInSeconds
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-ShareClient

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

Típus:	ShareClient
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ShareDirectoryClient

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

Típus:	ShareDirectoryClient
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ShareFileClient

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

Típus:	ShareFileClient
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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.

Típus:	String
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

Kimenetek

AzureStorageFile

Megosztás a következőn keresztül: