Get-AzStorageFileContent

Referensi

Modul:: Az.Storage

Mengunduh konten file.

Sintaks

Get-AzStorageFileContent
   [-ShareName] <String>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Get-AzStorageFileContent
   [-Share] <CloudFileShare>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Get-AzStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Path] <String>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [-PreserveSMBAttribute]
   [<CommonParameters>]

Get-AzStorageFileContent
   [-File] <CloudFile>
   [[-Destination] <String>]
   [-CheckMd5]
   [-PassThru]
   [-Force]
   [-AsJob]
   [-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

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

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

Contoh 2: Mengunduh file di bawah berbagi file sampel

PS C:\>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 persert properti Azure File SMB (Attributte File, Waktu Pembuatan File, Waktu Tulis Terakhir File) di file lokal.

PS C:\>Get-AzStorageFileContent -ShareName sample -Path "dir1/file1" -Destination $localFilePath -PreserveSMBAttribute

Contoh ini mengunduh file Azure ke file lokal, dan mempertahankan properti Azure File SMB (Attributte File, Waktu Pembuatan File, Waktu Tulis Terakhir File) di file lokal.

Parameter

-AsJob

Jalankan cmdlet di latar belakang.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckMd5

Menentukan apakah akan memeriksa jumlah Md5 untuk file yang diunduh.

Type:	SwitchParameter
Position:	Named
Default value:	None
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 mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.

Type:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
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.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Menentukan konteks Azure Storage. Untuk mendapatkan konteks, gunakan cmdlet New-AzStorageContext.

Type:	IStorageContext
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
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 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 Paksa, cmdlet akan meminta Anda sebelum berlanjut. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Type:	String
Position:	2
Default value:	None
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.

Type:	CloudFileDirectory
Aliases:	CloudFileDirectory
Position:	0
Default value:	None
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-AzStorageFile.

Type:	CloudFile
Aliases:	CloudFile
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Jika Anda menentukan jalur file yang tidak ada, cmdlet ini 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 Paksa, cmdlet akan meminta Anda sebelum berlanjut. Jika Anda menentukan jalur folder, cmdlet ini mencoba membuat file yang memiliki nama file penyimpanan Azure.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Menunjukkan bahwa cmdlet ini mengembalikan objek AzureStorageFile yang diunduhnya.

Type:	SwitchParameter
Position:	Named
Default value:	None
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.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PreserveSMBAttribute

Pertahankan properti SMB File sumber (Attributte File, Waktu Pembuatan File, Waktu Penulisan Terakhir File) di File tujuan. Parameter ini hanya tersedia di Windows.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerTimeoutPerRequest

Menentukan interval waktu habis sisi layanan, dalam detik, untuk permintaan. Jika interval yang ditentukan berlalu sebelum layanan memproses permintaan, layanan penyimpanan mengembalikan kesalahan.

Type:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
Position:	Named
Default value:	None
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 .

Type:	CloudFileShare
Aliases:	CloudFileShare
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareName

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

Type:	String
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

CloudFileShare

CloudFileDirectory

CloudFile

IStorageContext

Output

AzureStorageFile