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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckMd5
Menentukan apakah akan memeriksa jumlah Md5 untuk file yang diunduh.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
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
Menentukan konteks Azure Storage. Untuk mendapatkan konteks, gunakan cmdlet New-AzStorageContext.
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-AzStorageDirectory. Anda juga dapat menggunakan cmdlet Get-AzStorageFile untuk mendapatkan direktori.
Jenis: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisAllowTrailingDot
Larang titik berikutnya (.) untuk mencukupkan direktori dan nama file.
Jenis: | SwitchParameter |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | False |
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-AzStorageFile.
Jenis: | CloudFile |
Aliases: | 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
Menunjukkan bahwa cmdlet ini mengembalikan objek AzureStorageFile yang diunduhnya.
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 |
-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 |
Accept pipeline input: | False |
Accept wildcard characters: | 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] |
Aliases: | ServerTimeoutPerRequestInSeconds |
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-AzStorageShare. Objek ini berisi konteks penyimpanan. Jika Anda menentukan parameter ini, jangan tentukan parameter Konteks .
Jenis: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
nilai default: | None |
Diperlukan: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareClient
Objek CloudFileShare menunjukkan berbagi tempat file akan diunduh.
Jenis: | ShareClient |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareDirectoryClient
Objek ShareDirectoryClient menunjukkan direktori cloud tempat file akan diunduh.
Jenis: | ShareDirectoryClient |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareFileClient
Objek ShareFileClient menunjukkan file cloud yang akan diunduh.
Jenis: | ShareFileClient |
Position: | Named |
nilai default: | None |
Diperlukan: | False |
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 |