Get-AzStorageFileContent

Modul:

Az.Storage Module

Letölti egy fájl tartalmát.

Syntax

ShareName (Alapértelmezett)

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>]

Share

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>]

Directory

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>]

File

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 őrizze meg az Azure File SMB tulajdonságait (fájlattribútumok, fájllétrehozási idő, fájl utolsó írási ideje) a helyi fájlban.

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 megőrzi az Azure File SMB tulajdonságait (fájlattribútumok, 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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-CheckMd5

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	Nullable<T>[Int32]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	ClientTimeoutPerRequestInSeconds

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	Nullable<T>[Int32]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Confirm

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Context

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

Paramétertulajdonságok

Típus:	IStorageContext
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-DefaultProfile

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

Paramétertulajdonságok

Típus:	IAzureContextContainer
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	AzureRmContext, AzureCredential

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	2
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-DisAllowTrailingDot

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ShareName

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PassThru

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ShareName

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

Share

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

Directory

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PreserveSMBAttribute

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	Nullable<T>[Int32]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	ServerTimeoutPerRequestInSeconds

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ShareClient

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

Paramétertulajdonságok

Típus:	ShareClient
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Share

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ShareDirectoryClient

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

Paramétertulajdonságok

Típus:	ShareDirectoryClient
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Directory

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ShareFileClient

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

Paramétertulajdonságok

Típus:	ShareFileClient
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

File

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

ShareName

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-WhatIf

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

ShareClient

ShareDirectoryClient

ShareFileClient

IStorageContext

Kimenetek

AzureStorageFile

Kapcsolódó hivatkozások

• Get-AzStorageFile
• Set-AzStorageFileContent