Get-AzStorageFileContent

  • Reference
Modul:
Az.Storage

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

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 "CloudFile"} | 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 zobrazí výzvu 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

-Directory

Určuje složku jako objekt CloudFileDirectory . Tato rutina získá obsah souboru ve složce, kterou tento parametr určuje. K získání adresáře použijte rutinu New-AzStorageDirectory. K získání adresáře můžete použít také rutinu Get-AzStorageFile.

Typ:CloudFileDirectory
Aliasy:CloudFileDirectory
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
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

-File

Určuje soubor jako objekt CloudFile . Tato rutina získá soubor, který tento parametr určuje. K získání objektu CloudFile použijte rutinu Get-AzStorageFile.

Typ:CloudFile
Aliasy:CloudFile
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
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 vrátí 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

-Share

Určuje objekt CloudFileShare . Tato rutina stáhne obsah souboru ve sdílené složce, který tento parametr určuje. K získání objektu CloudFileShare použijte rutinu Get-AzStorageShare. Tento objekt obsahuje kontext úložiště. Pokud zadáte tento parametr, nezadávejte parametr Context .

Typ:CloudFileShare
Aliasy:CloudFileShare
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ShareClient

Objekt CloudFileShare označil sdílenou složku, do které se soubor stáhl.

Typ:ShareClient
Position:Named
Default value:None
Vyžadováno:False
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:Named
Default value:None
Vyžadováno:False
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:Named
Default value:None
Vyžadováno:False
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

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Výstupy

AzureStorageFile