Set-AzStorageFileContent

Mengunggah konten file.

Sintaks

ShareName (Default)

Set-AzStorageFileContent
    [-ShareName] <String>
    [-Source] <String>
    [[-Path] <String>]
    [-FileMode <String>]
    [-Owner <String>]
    [-Group <String>]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-DisAllowTrailingDot]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Share

Set-AzStorageFileContent
    [-ShareClient] <ShareClient>
    [-Source] <String>
    [[-Path] <String>]
    [-FileMode <String>]
    [-Owner <String>]
    [-Group <String>]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Directory

Set-AzStorageFileContent
    [-ShareDirectoryClient] <ShareDirectoryClient>
    [-Source] <String>
    [[-Path] <String>]
    [-FileMode <String>]
    [-Owner <String>]
    [-Group <String>]
    [-PassThru]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [-PreserveSMBAttribute]
    [<CommonParameters>]

Deskripsi

Cmdlet Set-AzStorageFileContent mengunggah konten file ke file pada berbagi tertentu.

Contoh

Contoh 1: Mengunggah file di folder saat ini

Set-AzStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"

Perintah ini mengunggah file yang diberi nama DataFile37 di folder saat ini sebagai file yang bernama CurrentDataFile di folder bernama ContosoWorkingFolder.

Contoh 2: Unggah semua file di folder saat ini

$CurrentFolder = (Get-Item .).FullName
$Container = Get-AzStorageShare -Name "ContosoShare06"
Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
    $path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
    Set-AzStorageFileContent -ShareClient $Container -Source $_.FullName -Path $path -Force
}

Contoh ini menggunakan beberapa cmdlet PowerShell Windows umum dan cmdlet saat ini untuk mengunggah semua file dari folder saat ini ke folder akar kontainer ContosoShare06. Perintah pertama mendapatkan nama folder saat ini dan menyimpannya dalam variabel $CurrentFolder. Perintah kedua menggunakan cmdlet Get-AzStorageShare untuk mendapatkan berbagi file bernama ContosoShare06, lalu menyimpannya dalam variabel $Container. Perintah akhir mendapatkan konten folder saat ini dan meneruskan masing-masing ke cmdlet Where-Object dengan menggunakan operator alur. Cmdlet itu memfilter objek yang bukan file, lalu meneruskan file ke cmdlet ForEach-Object. Cmdlet tersebut menjalankan blok skrip untuk setiap file yang membuat jalur yang sesuai untuknya lalu menggunakan cmdlet saat ini untuk mengunggah file. Hasilnya memiliki nama yang sama dan posisi relatif yang sama sehubungan dengan file lain yang diunggah contoh ini. Untuk informasi selengkapnya tentang blok skrip, ketik Get-Help about_Script_Blocks.

Contoh 3: Unggah file lokal ke file Azure, dan pertahankan properti File SMB lokal (Atribut File, Waktu Pembuatan File, Waktu Tulis Terakhir File) dalam file Azure.

Set-AzStorageFileContent -Source $localFilePath -ShareName sample -Path "dir1/file1" -PreserveSMBAttribute

Contoh ini mengunggah file lokal ke file Azure, dan mempertahankan properti File SMB lokal (Atribut File, Waktu Pembuatan File, Waktu Tulis Terakhir File) dalam file Azure.

Contoh 4: Mengunggah file dengan FileMode, Pemilik, dan Grup ke berbagi file NFS

Set-AzStorageFileContent -ShareName "contososhare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile" -FileMode rw-r--rwt -Owner 1 -Group 1

Perintah ini mengunggah file lokal ke file Azure dengan FileMode rwxrwSrwx, Pemilik 1 dan Grup 1. FileMode, Pemilik, Grup hanya berfungsi pada berbagi file NFS.

Parameter

-AsJob

Jalankan cmdlet di latar belakang.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:

Nullable<T>[Int32]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa: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.

Properti parameter

Jenis:

Nullable<T>[Int32]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Context

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

Properti parameter

Jenis:IStorageContext
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-DefaultProfile

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

Properti parameter

Jenis:IAzureContextContainer
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-DisAllowTrailingDot

Larang titik berikutnya (.) untuk mencukupkan direktori dan nama file.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ShareName
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-FileMode

Hanya berlaku untuk File NFS. Izin mode yang akan diatur pada file. Simbolis (rwxrw-rw-) didukung.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Force

Menunjukkan bahwa cmdlet ini menimpa file penyimpanan Azure yang ada.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Group

Hanya berlaku untuk File NFS. Pengidentifikasi grup pemilik (GID) yang akan diatur pada file. Nilai defaultnya adalah 0 (grup akar).

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Owner

Hanya berlaku untuk File NFS. Pengidentifikasi pengguna pemilik (UID) yang akan diatur pada file. Nilai defaultnya adalah 0 (root).

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PassThru

Menunjukkan bahwa cmdlet ini mengembalikan objek AzureStorageFile yang dibuat atau diunggahnya.

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Path

Menentukan jalur file atau folder. Cmdlet ini mengunggah konten ke file yang ditentukan parameter ini, atau ke file di folder yang ditentukan parameter ini. Jika Anda menentukan folder, cmdlet ini akan membuat file yang memiliki nama yang sama dengan file sumber. Jika Anda menentukan jalur file yang tidak ada, cmdlet ini akan membuat file tersebut dan menyimpan konten ke file tersebut. Jika Anda menentukan file yang sudah ada, dan Anda menentukan parameter Force , cmdlet ini menimpa konten file. Jika Anda menentukan file yang sudah ada dan Anda tidak menentukan Force, cmdlet ini tidak membuat perubahan, dan mengembalikan kesalahan. Jika Anda menentukan jalur folder yang tidak ada, cmdlet ini tidak membuat perubahan, dan mengembalikan kesalahan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:2
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-PreserveSMBAttribute

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

Properti parameter

Jenis:SwitchParameter
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ServerTimeoutPerRequest

Menentukan lamanya periode waktu habis untuk bagian server dari permintaan.

Properti parameter

Jenis:

Nullable<T>[Int32]

Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-ShareClient

Objek ShareClient menunjukkan berbagi tempat file akan diunggah.

Properti parameter

Jenis:ShareClient
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Share
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ShareDirectoryClient

Objek ShareDirectoryClient menunjukkan direktori tempat file akan diunggah.

Properti parameter

Jenis:ShareDirectoryClient
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Directory
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-ShareName

Menentukan nama berbagi file. Cmdlet ini mengunggah ke file dalam berbagi file yang ditentukan parameter ini.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

ShareName
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Source

Menentukan file sumber yang diunggah cmdlet ini. Jika Anda menentukan file yang tidak ada, cmdlet ini mengembalikan kesalahan.

Properti parameter

Jenis:String
Nilai default:None
Mendukung wildcard:False
DontShow:False
Alias:Nama Lengkap

Kumpulan parameter

(All)
Position:1
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

ShareClient

ShareDirectoryClient

String

IStorageContext

Output

AzureStorageFile