Get-AzureStorageFileContent
Stáhne obsah souboru.
Upozorňující
Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
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
Rutina Get-AzureStorageFileContent 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
PS C:\>Get-AzureStorageFileContent -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: Stažení souborů pod ukázkovou sdílenou složkou
PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContentTento příklad stáhne soubory pod ukázkovou sdílenou složkou.
Parametry
-CheckMd5
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 |
-ClientTimeoutPerRequest
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: | Nullable<T>[Int32] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ConcurrentTaskCount
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: | 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
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: | 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-AzureStorageDirectory. K získání adresáře můžete použít také rutinu Get-AzureStorageFile.
| Typ: | CloudFileDirectory |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| 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-AzureStorageFile.
| Typ: | 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
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 |
-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 |
-ServerTimeoutPerRequest
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: | Nullable<T>[Int32] |
| 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-AzureStorageShare. Tento objekt obsahuje kontext úložiště. Pokud zadáte tento parametr, nezadávejte parametr Context .
| Typ: | CloudFileShare |
| 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
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
Parametry: Share (ByValue)
Parametry: Adresář (ByValue)
Parametry: Soubor (ByValue)