Redirections.xml profilu niestandardowego

• Samouczek: tworzenie i implementowanie redirections.xml
• Często zadawane pytania: przekierowania lub redirections.xml

Niestandardowe przekierowania profilów są konfigurowane przy użyciu pliku XML (redirections.xml) znajdującego się w kontenerze profilu użytkownika. FsLogix nie tworzy pliku redirections.xml. Plik redirections.xml jest kopiowany do kontenera profilu użytkownika z lokalizacji źródłowej. W większości przypadków lokalizacja źródłowa jest zdalnym udziałem plików, w którym użytkownicy mają dostęp do kopiowania danych z i do kontenera profilu. Ten dokument zawiera szczegółowe informacje na temat pliku redirection.xml i sposobu, w jaki najlepiej go zaimplementować dla konkretnego przypadku użycia.

Kiedy należy używać redirections.xml

Dane w profilu użytkownika nie są przeznaczone do usuwania ani wykluczania. Jeśli nie masz intymnej wiedzy na temat danych w profilu lub aplikacji, nie wykluczaj ich z kontenera.

Dołączanie i wykluczanie plików i folderów w kontenerze profilu

Aby dołączyć /wykluczyć pliki i / lub foldery w kontenerze profilu użytkowników, należy utworzyć plik o nazwie redirections.xml. Ten plik definiuje, co należy skopiować lub wykluczyć z kontenera profilu użytkownika. Plik XML jest przetwarzany podczas logowania użytkowników i wylogowania się z maszyny wirtualnej. Wszelkie zmiany wprowadzone w pliku XML, gdy użytkownik jest zalogowany do maszyny wirtualnej, nie zostaną wprowadzone do momentu wylogowania się i zalogowania.

Usunięcie lub zmiana nazwy pliku XML w lokalizacji źródłowej nie powoduje usunięcia ani zmiany jego nazwy dla użytkowników. Jeśli konieczne jest usunięcie niestandardowych przekierowań, wyczyść zawartość pliku XML i zapisz ją w lokalizacji źródłowej. Podczas następnego logowania zaktualizowany plik zostanie skopiowany do kontenera profilu użytkownika.

Uwaga

redirections.xml ma zastosowanie tylko w przypadku używania z kontenerami profilów i nie ma wpływu na używanie kontenerów ODFC.

Lokalizacje redirections.xml

Plik XML ma dwie lokalizacje (2). Lokalizacja źródłowa, zazwyczaj zdalny udział plików i lokalizacja w kontenerze profilu użytkownika.

Lokalizacja pliku źródłowego

Plik XML można centralnie znaleźć w celu łatwego rozkładu. Ustawienie RedirXMLSourceFolder określa lokalizację, w której klient sprawdza podczas logowania, aby sprawdzić, czy istnieje plik redirections.xml. Jeśli jeden zostanie znaleziony i różni się od istniejącego, zostanie skopiowany do kontenera profilu użytkownika. Następnie zawartość jest przetwarzana.

W przypadku przechowywania w centralnej lokalizacji (na przykład katalogu głównego lub podkatalogu, w którym są przechowywane kontenery profilu użytkownika), upewnij się, że użytkownicy mają tylko uprawnienia do odczytu do pliku XML.

Uwaga

Określ tylko ścieżkę do pliku redirections.xml, nie określaj nazwy pliku.

Lokalizacja profilu użytkownika

Plik redirections.xml znajduje się w następującej lokalizacji podczas kopiowania z lokalizacji źródłowej:

• %userprofile%\AppData\Local\FSLogix\redirections.xml (wewnątrz kontenera profilu użytkownika)

Ważne

Jeśli jakiekolwiek wpisy lub wpisy w redirections.xml zostaną usunięte, zawartość lub foldery pozostają w dysku VHD(x). Wszystkie elementy dodane w redirections.xml są umieszczane w folderze local_%username% , ale to, co już istnieje w dysku VHD(x) nie jest usuwane z dysku VHD(x).

Zawartość pliku XML

Plik redirections.xml składa się z deklaracji XML, trzech (3) elementów i dwóch (2) atrybutów. Deklaracja XML jest standardowa i nie powinna być zmieniana.

Elementy i atrybuty

• FrxProfileFolderRedirection: jest to pierwszy element w pliku XML i powinien być używany tylko raz.

  • ExcludeCommonFolders: ten atrybut określa, które (jeśli istnieją) dobrze znane foldery powinny zostać przekierowane z kontenera profilu użytkownika. Ten atrybut przyjmuje wartość maski bitowej, która informuje FSLogix, która kombinacja folderów do wykluczenia. Dodaj wartości dla wszystkich folderów, które mają zostać wykluczone. Na przykład wartość 7 wyklucza foldery Kontakty, Komputery i Dokumenty.

    • 1: Folder kontaktów
    • 2: Folder pulpitu
    • 4: Folder Dokumenty
    • 8: Folder do pobrania
    • 16: Folder łączy
    • 32: Foldery muzyczne
    • 64: Obrazy i foldery wideo
    • 128: Foldery zaangażowane w procesy niskiego poziomu integralności, takie jak AppData\LocalLow

  • Wyklucza: ten element jest używany do kolekcji zagnieżdżonych Exclude elementów.

    • Wyklucz: ten element opisuje jedną lokalizację do wykluczenia z kontenera użytkownika. Ścieżka używana w tych elementach musi istnieć w ścieżce profilu użytkownika (%userprofile%). Ścieżka nie może zawierać C:\Users\%username% części ścieżki.
      • Kopiowanie: ten atrybut definiuje sposób, w jaki fsLogix obsługuje pliki i foldery podczas przekierowywania. Atrybut można pominąć z elementu, który jest taki sam jak przy użyciu wartości 0.
        • 0: Tworzy pusty folder w local_%username% katalogu. Podczas operacji nie są kopiowane żadne pliki. Kopiowanie 0 jest najczęstszą wartością używaną do zmniejszenia zawartości profilu użytkownika. Wszystkie dane, które są już w kontenerze w lokalizacji, nie są usuwane. Tylko przyszłe dane są tworzone w local_%username% folderze podczas sesji użytkownika i usuwane po wylogowaniu.
        • 1: Tworzy folder w local_%username% katalogu I kopiuje pliki Z określonej lokalizacji. Dane w kontenerze są kopiowane do local_%username% folderu, a wszystkie nowe dane są również zapisywane w tej ścieżce. Po wylogowaniu local_%username% użytkownika użytkownik zostanie usunięty i wszystkie nowe dane zostaną utracone. N^logowania zawsze kopiuje dane z kontenera local_%username% do folderu.
        • 2: Tworzy folder w local_%username% katalogu AND kopiuje pliki do określonej lokalizacji. W programie local_%username%zostanie utworzony nowy (pusty) folder . Podczas sesji użytkownika dane są zapisywane w tej ścieżce. Po wylogowaniu dane są kopiowane do kontenera. Nie używaj tej wartości, chyba że zostanie skierowany przez inżyniera pomocy technicznej firmy Microsoft.
        • 3: Tworzy folder w local_%username% katalogu AND kopiuje pliki FROM i DO określonej lokalizacji. Ta wartość łączy efekty z wartości 1 i 2. Istniejące dane są kopiowane z kontenera i do local_%username% folderu. Nowe dane są zapisywane w ścieżce local_%username% i podczas wylogowywania wszystkie dane są kopiowane z powrotem do kontenera.

  • Obejmuje: ten element jest używany dla kolekcji zagnieżdżonych Include elementów.

    • Uwzględnij: ten element służy do zapewnienia, że podkatalog ścieżki wykluczania jest przechowywany w kontenerze. Wartość COPY nie jest używana w tych elementach. Ścieżka używana w tych elementach musi istnieć w ścieżce profilu użytkownika (%userprofile%). Ścieżka nie może zawierać C:\Users\%username% części ścieżki.

    Uwaga

    • Folder lub dane muszą istnieć w profilu, który ma zostać dołączony z powrotem do kontenera. Na przykład nowe profile korzystające z pliku FSLogix z instrukcją include mogą nie mieć wszystkich struktur folderów utworzonych dla określonej ścieżki, ponieważ użytkownik nigdy nie używał aplikacji w kontekście kontenera profilów FSLogix.
    • Folder nadrzędny dołączonej ścieżki folderu MUSI istnieć w kontenerze, aby dołączenie działało poprawnie.
    • Plik XML zaakceptuje dowolną liczbę Include elementów i Exclude .

Przykład redirections.xml

Ważne

W tym przykładzie pokazano, jak można używać elementów. Postępuj zgodnie z artykułem Tworzenie i implementowanie redirections.xml samouczka dotyczącego implementacji kodu XML w świecie rzeczywistym. Exclues i zawiera może mieć nieoczekiwane konsekwencje i musi zostać stworzony z ostrożnością.

1. Wyklucz dobrze znane foldery (kontakty, linki i muzyka)
2. Wyklucz aplikację Contoso Sales, kopiując wszystkie dane z kontenera do local_%username% folderu i z powrotem do kontenera po wylogowaniu. Instrukcja exclude z kopią przenosi operacje we/wy danych na dysk lokalny zamiast kontenera¹.
3. Wyklucz folder przeglądarki Microsoft Edge bez operacji kopiowania (wszystkie dane są usuwane podczas wylogowywanie).
4. Dołącz folder z powrotem User Data do wykluczonego folderu przeglądarki Microsoft Edge.

^{1 Operacje we/wy są nadal wymagane do skopiowania danych.}

<?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>

Uwaga

• W systemie Windows 8 lub nowszym foldery związane z procesami niskiego poziomu integralności są zawsze przekierowywane do local_%username% katalogu.
• Jeśli ten sam folder jest określony w obu Exclude elementach i Include , pierwszeństwo Exclude będzie mieć.
• Aby wyświetlić listę przekierowań wprowadzonych przez fsLogix, użyj narzędzia wiersza polecenia frx.

Następne kroki

redirections.xml — często zadawane pytania