Bagikan melalui

Profil kustom redirections.xml

  • Artikel

Pengalihan profil kustom dikonfigurasi menggunakan file XML (redirections.xml) yang terletak di dalam kontainer profil pengguna. FSLogix tidak membuat file redirections.xml. File redirections.xml disalin ke kontainer profil pengguna dari lokasi sumber. Dalam kebanyakan kasus, lokasi sumber adalah berbagi file jarak jauh di mana pengguna memiliki akses untuk menyalin dari dan ke dalam kontainer profil mereka. Dokumen ini menyediakan detail tentang file redirection.xml dan cara terbaik untuk mengimplementasikannya untuk kasus penggunaan spesifik Anda.

Kapan menggunakan redirections.xml

Data di profil pengguna tidak dirancang untuk dihapus atau dikecualikan. Kecuali Anda memiliki pengetahuan intim tentang data di profil atau aplikasi, jangan mengecualikannya dari kontainer.

Sertakan dan Kecualikan file dan folder dalam kontainer Profil

Untuk menyertakan / mengecualikan file dan / atau folder dalam kontainer profil pengguna, Anda perlu membuat file yang disebut redirections.xml. File ini menentukan apa yang harus disalin atau dikecualikan ke / dari kontainer profil pengguna. File XML diproses selama pengguna masuk dan keluar dari komputer virtual. Setiap perubahan yang dilakukan pada file XML saat pengguna masuk ke komputer virtual, tidak berlaku sampai mereka keluar dan masuk.

Menghapus atau mengganti nama file XML di lokasi sumber tidak menghapus atau mengganti nama untuk pengguna. Jika perlu menghapus pengalihan kustom, hapus konten file XML dan simpan ke lokasi sumber. Pada rincian masuk berikutnya, file yang diperbarui akan disalin ke kontainer profil pengguna.

Catatan

redirections.xml hanya berlaku saat digunakan dengan kontainer profil dan tidak berpengaruh saat menggunakan kontainer ODFC.

Lokasi untuk redirections.xml

File XML memiliki dua (2) lokasi. Lokasi sumber, biasanya berbagi file jarak jauh, dan lokasi dalam kontainer profil pengguna.

Lokasi File Sumber

File XML dapat ditemukan secara terpusat untuk distribusi yang mudah. Pengaturan RedirXMLSourceFolder menentukan lokasi di mana klien memeriksa saat masuk untuk melihat apakah ada file redirections.xml. Jika ditemukan dan berbeda dari yang sudah ada, itu disalin ke kontainer profil pengguna. Kemudian konten diproses.

Saat disimpan di lokasi pusat (misalnya, akar atau subdirektori tempat kontainer profil pengguna disimpan), pastikan pengguna hanya memiliki izin baca ke file XML.

Catatan

Hanya tentukan jalur ke file redirections.xml, jangan tentukan nama file.

Lokasi Profil Pengguna

File redirections.xml berada di lokasi berikut saat disalin dari lokasi sumber:

  • %userprofile%\AppData\Local\FSLogix\redirections.xml (di dalam kontainer profil pengguna)

Penting

Jika ada entri atau entri dalam redirections.xml dihapus, konten atau folder tetap berada di VHD(x). Apa pun yang ditambahkan dalam redirections.xml dimasukkan ke dalam folder local_%username% , tetapi apa yang sudah ada di VHD(x) tidak dihapus dari VHD(x).

Isi File XML

File redirections.xml terdiri dari deklarasi XML, tiga (3) elemen dan dua (2) atribut. Deklarasi XML adalah standar dan tidak boleh diubah.

Elemen dan Atribut

  • FrxProfileFolderRedirection: Ini adalah elemen pertama dalam file XML dan harus digunakan hanya sekali.

    • ExcludeCommonFolders: Atribut ini menentukan folder mana yang (jika ada) terkenal yang harus dialihkan dari kontainer profil pengguna. Atribut ini mengambil nilai bitmask yang memberi tahu FSLogix kombinasi folder mana yang akan dikecualikan. Tambahkan nilai untuk semua folder yang akan dikecualikan. Misalnya, nilai 7 mengecualikan folder Kontak, Desktop, dan Dokumen.

      • 1: Folder kontak
      • 2: Folder desktop
      • 4: Folder dokumen
      • 8: Folder unduhan
      • 16: Folder tautan
      • 32: Folder musik
      • 64: Folder Gambar dan Video
      • 128: Folder yang terlibat dalam proses Tingkat Integritas Rendah seperti AppData\LocalLow

    • Mengecualikan: Elemen ini digunakan untuk kumpulan elemen berlapis Exclude .

      • Kecualikan: Elemen ini menjelaskan satu lokasi untuk dikecualikan dari kontainer pengguna. Jalur yang digunakan dalam elemen-elemen ini harus ada di jalur profil pengguna (%userprofile%). Jalur TIDAK boleh menyertakan C:\Users\%username% bagian dari jalur.
        • Salin: Atribut ini menentukan bagaimana FSLogix menangani file dan folder selama pengalihan. Atribut dapat dihilangkan dari elemen yang sama dengan menggunakan nilai 0.
          • 0: Membuat folder kosong di local_%username% direktori. Tidak ada file yang disalin selama operasi. Salin 0 adalah nilai paling umum yang digunakan untuk mengurangi konten profil pengguna. Data apa pun yang sudah ada dalam kontainer di lokasi tidak dihapus. Hanya data di masa mendatang yang local_%username% dibuat di folder selama sesi pengguna dan dihapus saat keluar.
          • 1: Membuat folder di local_%username% direktori DAN menyalin file DARI lokasi yang ditentukan. Data dalam kontainer disalin ke local_%username% folder dan data baru apa pun juga ditulis ke jalur tersebut. Saat pengguna keluar, local_%username% dihapus dan data baru hilang. MasukN th selalu menyalin data dari kontainer ke local_%username% folder.
          • 2: Membuat folder di local_%username% direktori DAN menyalin file ke lokasi yang ditentukan. Folder baru (kosong) dibuat di local_%username%. Selama sesi pengguna, data ditulis ke jalur tersebut. Saat keluar, data disalin ke dalam kontainer. Jangan gunakan nilai ini kecuali diarahkan oleh teknisi dukungan Microsoft.
          • 3: Membuat folder di local_%username% direktori DAN menyalin file DARI dan KE lokasi yang ditentukan. Nilai ini menggabungkan efek dari 1 dan 2. Data yang ada disalin dari kontainer dan ke local_%username% dalam folder. Data baru ditulis ke local_%username% jalur dan saat keluar, semua data disalin kembali ke kontainer.

    • Termasuk: Elemen ini digunakan untuk kumpulan elemen berlapis Include .

      • Sertakan: Elemen ini digunakan untuk memastikan subdirektori jalur pengecualian disimpan dalam kontainer. Nilai COPY tidak digunakan dalam elemen ini. Jalur yang digunakan dalam elemen-elemen ini harus ada di jalur profil pengguna (%userprofile%). Jalur TIDAK boleh menyertakan C:\Users\%username% bagian dari jalur.

      Catatan

      • Folder atau data harus ada di profil untuk disertakan kembali ke dalam kontainer. Misalnya, profil baru yang menggunakan FSLogix dengan pernyataan sertakan mungkin tidak memiliki semua struktur folder yang dibuat untuk jalur tertentu karena pengguna belum pernah menggunakan aplikasi dalam konteks kontainer profil FSLogix mereka.
      • Folder induk dari jalur folder yang disertakan HARUS ada dalam kontainer agar sertakan berfungsi dengan benar.
      • File XML akan menerima sejumlah Include elemen dan Exclude .

Contoh redirections.xml

Penting

Contoh ini menunjukkan bagaimana elemen dapat digunakan. Ikuti tutorial Membuat dan menerapkan redirections.xml untuk implementasi XML dunia nyata. Mengecualikan dan menyertakan dapat memiliki konsekuensi yang tidak terduga dan harus dibuat dengan hati-hati.

  1. Mengecualikan folder terkenal (Kontak, Tautan, dan Musik)
  2. Kecualikan Contoso Sales App, menyalin data apa pun dari kontainer ke local_%username% folder dan kembali ke kontainer saat keluar. Pernyataan kecualikan dengan salinan memindahkan I/O data ke disk lokal alih-alih kontainer1.
  3. Kecualikan folder Microsoft Edge tanpa operasi salin (semua data dihapus saat keluar).
  4. Sertakan User Data kembali folder di dalam folder Microsoft Edge yang dikecualikan.

1 I/O masih diperlukan untuk menyalin data.

<?xml version="1.0"  encoding="UTF-8"?>
<FrxProfileFolderRedirection ExcludeCommonFolders="49">
<Excludes>
<Exclude Copy="3">AppData\Roaming\Contoso\ContosoSalesApp</Exclude>
<Exclude Copy="0">AppData\Local\Microsoft\Edge</Exclude>
</Excludes>
<Includes>
<Include>AppData\Local\Microsoft\Edge\User Data</Include>
</Includes>
</FrxProfileFolderRedirection>

Catatan

  • Pada Windows 8 dan yang lebih baru, folder yang terlibat dalam proses Tingkat Integritas Rendah SELALU dialihkan ke local_%username% direktori.
  • Jika folder yang sama ditentukan dalam Exclude elemen dan Include , Exclude akan diutamakan.
  • Untuk mencantumkan pengalihan yang diberlakukan oleh FSLogix, gunakan utilitas baris perintah frx.

Langkah berikutnya

Tanya Jawab Umum redirections.xml