Get-AzStorageFileContent
Stáhne obsah souboru.
Syntaxe
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
Rutina Get-AzStorageFileContent stáhne obsah souboru a uloží ho do zadaného cíle. Tato rutina nevrací obsah souboru.
Příklady
Příklad 1: Stažení souboru ze složky
Get-AzStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"
Tento příkaz stáhne soubor s názvem CurrentDataFile ve složce ContosoWorkingFolder ze sdílené složky ContosoShare06 do aktuální složky.
Příklad 2: Stáhne soubory pod ukázkovou sdílenou složkou.
Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "AzureStorageFile"} | Get-AzStorageFileContent
Tento příklad stáhne soubory pod ukázkovou sdílenou složkou.
Příklad 3: Stáhněte si soubor Azure do místního souboru a zarezervujte vlastnosti SMB souboru Azure (File Attributtes, File Creation Time, File Last Write Time) v místním souboru.
Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute
Tento příklad stáhne soubor Azure do místního souboru a zarezervuje vlastnosti SMB souboru Azure (File Attributtes, File Creation Time, File Last Write Time) v místním souboru.
Parametry
-AsJob
Spusťte rutinu na pozadí.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-CheckMd5
Určuje, jestli chcete zkontrolovat součet Md5 pro stažený soubor.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ClientTimeoutPerRequest
Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.
Typ: | Nullable<T>[Int32] |
Aliasy: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ConcurrentTaskCount
Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.
Typ: | Nullable<T>[Int32] |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Context
Určuje kontext služby Azure Storage. K získání kontextu použijte rutinu New-AzStorageContext.
Typ: | IStorageContext |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Destination
Určuje cílovou cestu. Tato rutina stáhne obsah souboru do umístění, které tento parametr určuje. Pokud zadáte cestu k souboru, který neexistuje, tato rutina tento soubor vytvoří a uloží obsah do nového souboru. Pokud zadáte cestu k souboru, který již existuje, a zadáte parametr Force, rutina soubor přepíše. Pokud zadáte cestu existujícího souboru a nezadáte Force, rutina vás vyzve, než bude pokračovat. Pokud zadáte cestu ke složce, pokusí se tato rutina vytvořit soubor s názvem souboru úložiště Azure.
Typ: | String |
Position: | 2 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DisAllowTrailingDot
Zakázat koncové tečky (.) přípony adresáře a názvů souborů
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Force
Pokud zadáte cestu k souboru, který neexistuje, tato rutina tento soubor vytvoří a uloží obsah do nového souboru. Pokud zadáte cestu k souboru, který již existuje, a zadáte parametr Force, rutina soubor přepíše. Pokud zadáte cestu existujícího souboru a nezadáte Force, rutina vás vyzve, než bude pokračovat. Pokud zadáte cestu ke složce, pokusí se tato rutina vytvořit soubor s názvem souboru úložiště Azure.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PassThru
Označuje, že tato rutina vrací objekt AzureStorageFile, který stáhne.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Path
Určuje cestu k souboru. Tato rutina získá obsah souboru, který tento parametr určuje. Pokud soubor neexistuje, vrátí tato rutina chybu.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PreserveSMBAttribute
Ponechte vlastnosti SMB zdrojového souboru (File Attributtes, File Creation Time, File Last Write Time) v cílovém souboru. Tento parametr je k dispozici pouze ve Windows.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ServerTimeoutPerRequest
Určuje interval časového limitu na straně služby v sekundách pro požadavek. Pokud zadaný interval uplynou před tím, než služba zpracuje požadavek, služba úložiště vrátí chybu.
Typ: | Nullable<T>[Int32] |
Aliasy: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ShareClient
Objekt ShareClient označil sdílenou složku, do které se soubor stáhl.
Typ: | ShareClient |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ShareDirectoryClient
Objekt ShareDirectoryClient označil cloudový adresář, do kterého se soubor stáhl.
Typ: | ShareDirectoryClient |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ShareFileClient
Objekt ShareFileClient označil cloudový soubor, který se má stáhnout.
Typ: | ShareFileClient |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ShareName
Určuje název sdílené složky. Tato rutina stáhne obsah souboru ve sdílené složce, který tento parametr určuje.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Související odkazy
Azure PowerShell