Bagikan melalui

Get-AzureStorageFileContent

  • Referensi
Modul:
Azure.Storage

Mengunduh konten file.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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

Deskripsi

Cmdlet Get-AzureStorageFileContent mengunduh konten file, lalu menyimpannya ke tujuan yang Anda tentukan. Cmdlet ini tidak mengembalikan isi file.

Contoh

Contoh 1: Mengunduh file dari folder

PS C:\>Get-AzureStorageFileContent -ShareName "ContosoShare06" -Path "ContosoWorkingFolder/CurrentDataFile"

Perintah ini mengunduh file yang bernama CurrentDataFile di folder ContosoWorkingFolder dari berbagi file ContosoShare06 ke folder saat ini.

Contoh 2: Unduh file di bawah berbagi file sampel

PS C:\>Get-AzureStorageFile -ShareName sample | ? {$_.GetType().Name -eq "CloudFile"} | Get-AzureStorageFileContent

Contoh ini mengunduh file di bawah berbagi file sampel

Parameter

-CheckMd5

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:Nullable<T>[Int32]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:Nullable<T>[Int32]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Aliases:cf
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:IStorageContext
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Destination

Menentukan jalur tujuan. Cmdlet ini mengunduh konten file ke lokasi yang ditentukan parameter ini. Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:String
Position:2
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Directory

Menentukan folder sebagai objek CloudFileDirectory . Cmdlet ini mendapatkan konten untuk file di folder yang ditentukan parameter ini. Untuk mendapatkan direktori, gunakan cmdlet New-AzureStorageDirectory. Anda juga dapat menggunakan cmdlet Get-AzureStorageFile untuk mendapatkan direktori.

Jenis:CloudFileDirectory
Position:0
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-File

Menentukan file sebagai objek CloudFile . Cmdlet ini mendapatkan file yang ditentukan parameter ini. Untuk mendapatkan objek CloudFile , gunakan cmdlet Get-AzureStorageFile.

Jenis:CloudFile
Position:0
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:SwitchParameter
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Menentukan jalur file. Cmdlet ini mendapatkan konten file yang ditentukan parameter ini. Jika file tidak ada, cmdlet ini mengembalikan kesalahan.

Jenis:String
Position:1
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut, dan menyimpan konten dalam file baru. Jika Anda menentukan jalur file yang sudah ada dan Anda menentukan parameter Force , cmdlet akan menimpa file. Jika Anda menentukan jalur file yang ada dan Anda tidak menentukan Force, cmdlet akan meminta Anda sebelum melanjutkan. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Jenis:Nullable<T>[Int32]
Position:Named
nilai default:None
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

-Share

Menentukan objek CloudFileShare. Cmdlet ini mengunduh konten file dalam berbagi yang ditentukan parameter ini. Untuk mendapatkan objek CloudFileShare , gunakan cmdlet Get-AzureStorageShare. Objek ini berisi konteks penyimpanan. Jika Anda menentukan parameter ini, jangan tentukan parameter Konteks .

Jenis:CloudFileShare
Position:0
nilai default:None
Diperlukan:True
Accept pipeline input:True
Accept wildcard characters:False

-ShareName

Menentukan nama berbagi file. Cmdlet ini mengunduh konten file dalam berbagi yang ditentukan parameter ini.

Jenis:String
Position:0
nilai default:None
Diperlukan:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Aliases:wi
Position:Named
nilai default:False
Diperlukan:False
Accept pipeline input:False
Accept wildcard characters:False

Input

CloudFileShare

Parameter: Berbagi (ByValue)

CloudFileDirectory

Parameter: Direktori (ByValue)

CloudFile

Parameter: File (ByValue)

IStorageContext

Output

CloudFile