Get-AzStorageFileContent
Mengunduh konten file.
Sintaks
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>]
Deskripsi
Cmdlet Get-AzStorageFileContent mengunduh konten file, lalu menyimpannya ke tujuan yang Anda tentukan. Cmdlet ini tidak mengembalikan isi file.
Contoh
Contoh 1: Mengunduh file dari folder
Get-AzStorageFileContent -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: Mengunduh file di bawah contoh berbagi file
Get-AzStorageFile -ShareName sample | Where-Object {$_.GetType().Name -eq "CloudFile"} | Get-AzStorageFileContent
Contoh ini mengunduh file di bawah berbagi file sampel
Contoh 3: Unduh file Azure ke file lokal, dan persertasikan properti Azure File SMB (File Attributtes, Waktu Pembuatan File, Waktu Tulis Terakhir File) di file lokal.
Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute
Contoh ini mengunduh file Azure ke file lokal, dan mempertahankan properti Azure File SMB (File Attributtes, Waktu Pembuatan File, Waktu Tulis Terakhir File) dalam file lokal.
Parameter
-AsJob
Jalankan cmdlet di latar belakang.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CheckMd5
Menentukan apakah akan memeriksa jumlah Md5 untuk file yang diunduh.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ClientTimeoutPerRequest
Menentukan interval waktu habis sisi klien, dalam hitungan detik, untuk satu permintaan layanan. Jika panggilan sebelumnya gagal dalam interval yang ditentukan, cmdlet ini akan mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.
Jenis: | Nullable<T>[Int32] |
Alias: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ConcurrentTaskCount
Menentukan panggilan jaringan bersamaan maksimum. Anda dapat menggunakan parameter ini untuk membatasi konkurensi untuk membatasi penggunaan CPU dan bandwidth lokal dengan menentukan jumlah maksimum panggilan jaringan bersamaan. Nilai yang ditentukan adalah jumlah absolut dan tidak dikalikan dengan jumlah inti. Parameter ini dapat membantu mengurangi masalah koneksi jaringan di lingkungan bandwidth rendah, seperti 100 kilobit per detik. Nilai defaultnya adalah 10.
Jenis: | Nullable<T>[Int32] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Context
Menentukan konteks Azure Storage. Untuk mendapatkan konteks, gunakan cmdlet New-AzStorageContext.
Jenis: | IStorageContext |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.
Jenis: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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 |
Terima input alur: | False |
Terima karakter wildcard: | 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-AzStorageDirectory. Anda juga dapat menggunakan cmdlet Get-AzStorageFile untuk mendapatkan direktori.
Jenis: | CloudFileDirectory |
Alias: | CloudFileDirectory |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-DisAllowTrailingDot
Larang titik berikutnya (.) untuk mencukupkan direktori dan nama file.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-File
Menentukan file sebagai objek CloudFile . Cmdlet ini mendapatkan file yang ditentukan parameter ini. Untuk mendapatkan objek CloudFile , gunakan cmdlet Get-AzStorageFile.
Jenis: | CloudFile |
Alias: | CloudFile |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | 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 |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PassThru
Menunjukkan bahwa cmdlet ini mengembalikan objek AzureStorageFile yang diunduhnya.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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 |
Terima input alur: | False |
Terima karakter wildcard: | False |
-PreserveSMBAttribute
Pertahankan properti SMB File sumber (Attributte File, Waktu Pembuatan File, Waktu Tulis Terakhir File) di File tujuan. Parameter ini hanya tersedia di Windows.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ServerTimeoutPerRequest
Menentukan interval waktu habis sisi layanan, dalam hitungan detik, untuk permintaan. Jika interval yang ditentukan berlalu sebelum layanan memproses permintaan, layanan penyimpanan mengembalikan kesalahan.
Jenis: | Nullable<T>[Int32] |
Alias: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Share
Menentukan objek CloudFileShare. Cmdlet ini mengunduh konten file dalam berbagi yang ditentukan parameter ini. Untuk mendapatkan objek CloudFileShare , gunakan cmdlet Get-AzStorageShare. Objek ini berisi konteks penyimpanan. Jika Anda menentukan parameter ini, jangan tentukan parameter Konteks .
Jenis: | CloudFileShare |
Alias: | CloudFileShare |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ShareClient
Objek CloudFileShare menunjukkan berbagi tempat file akan diunduh.
Jenis: | ShareClient |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ShareDirectoryClient
Objek ShareDirectoryClient menunjukkan direktori cloud tempat file akan diunduh.
Jenis: | ShareDirectoryClient |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
-ShareFileClient
Objek ShareFileClient menunjukkan file cloud yang akan diunduh.
Jenis: | ShareFileClient |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | 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 |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | False |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |