Get-AzureStorageFileContent
Letölti egy fájl tartalmát.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
Syntax
Get-AzureStorageFileContent
[-ShareName] <String>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzureStorageFileContent
[-Share] <CloudFileShare>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzureStorageFileContent
[-Directory] <CloudFileDirectory>
[-Path] <String>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-AzureStorageFileContent
[-File] <CloudFile>
[[-Destination] <String>]
[-CheckMd5]
[-PassThru]
[-Force]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Get-AzureStorageFileContent 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
PS C:\>Get-AzureStorageFileContent -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: Fájlok letöltése mintafájlmegosztás alatt
PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent
Ez a példa letölti a fájlokat a mintafájlmegosztás alatt
Paraméterek
-CheckMd5
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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ClientTimeoutPerRequest
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.
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 |
-ConcurrentTaskCount
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.
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
Jóváhagyá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
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.
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 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.
Típus: | String |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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. Címtár beszerzéséhez használja a New-AzureStorageDirectory parancsmagot. A Get-AzureStorageFile parancsmaggal is beszerezhet egy könyvtárat.
Típus: | CloudFileDirectory |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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-AzureStorageFile parancsmagot.
Típus: | CloudFile |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
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 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-PassThru
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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ServerTimeoutPerRequest
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.
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 |
-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-AzureStorageShare 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.
Típus: | CloudFileShare |
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
Bemutatja, mi történne a parancsmag futtatásakor. 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
Paraméterek: Megosztás (ByValue)
Paraméterek: Könyvtár (ByValue)
Paraméterek: Fájl (ByValue)