Redirections.xml di profili personalizzati
- Esercitazione: Creare e implementare redirections.xml
- Domande frequenti: Reindirizzamenti o redirections.xml
I reindirizzamenti di profili personalizzati vengono configurati usando un file XML (redirections.xml) che si trova all'interno del contenitore del profilo dell'utente. FSLogix non crea il file redirections.xml. Il file redirections.xml viene copiato nel contenitore del profilo dell'utente da un percorso di origine. Nella maggior parte dei casi, il percorso di origine è una condivisione file remota in cui gli utenti hanno accesso per la copia da e nel contenitore del profilo. Questo documento fornisce informazioni dettagliate sul file di redirection.xml e sul modo migliore per implementarlo per il caso d'uso specifico.
Quando usare redirections.xml
I dati nel profilo dell'utente non sono progettati per essere rimossi o esclusi. A meno che non si abbia una conoscenza intima dei dati nel profilo o nell'applicazione, non escluderli dal contenitore.
Per includere/escludere file e/o cartelle all'interno di un contenitore di profili utente, è necessario creare un file denominato redirections.xml. Questo file definisce cosa copiare o escludere da /dal contenitore del profilo di un utente. Il file XML viene elaborato durante l'accesso e la disconnessazione di una macchina virtuale da parte di un utente. Tutte le modifiche apportate al file XML mentre l'utente ha eseguito l'accesso alla macchina virtuale, non ha effetto fino a quando non si disconnette e non esegue l'accesso.
La rimozione o la ridenominazione del file XML nel percorso di origine non comporta la rimozione o la ridenominazione per gli utenti. Se è necessario rimuovere i reindirizzamenti personalizzati, cancellare il contenuto del file XML e salvarlo nel percorso di origine. Al successivo accesso, il file aggiornato verrà copiato nel contenitore del profilo dell'utente.
Nota
redirections.xml è applicabile solo quando viene usato con i contenitori del profilo e non ha alcun effetto quando si usano contenitori ODFC.
Posizioni per redirections.xml
Il file XML ha due percorsi (2). Il percorso di origine, in genere una condivisione file remota e il percorso nel contenitore del profilo dell'utente.
Percorso file di origine
Il file XML può trovarsi centralmente per facilitare la distribuzione. L'impostazione RedirXMLSourceFolder specifica un percorso in cui il client controlla l'accesso per verificare se è presente un file redirections.xml. Se ne viene trovato uno diverso da quello esistente, viene copiato nel contenitore del profilo dell'utente. Il contenuto viene quindi elaborato.
Se archiviato in una posizione centrale (ad esempio, radice o sottodirectory in cui sono archiviati i contenitori del profilo utente), assicurarsi che gli utenti dispongano solo delle autorizzazioni di lettura per il file XML.
Nota
Specificare solo il percorso del file redirections.xml, non specificare il nome del file.
Posizione del profilo dell'utente
Il file redirections.xml si trova nel percorso seguente quando viene copiato dal percorso di origine:
%userprofile%\AppData\Local\FSLogix\redirections.xml
(all'interno del contenitore del profilo dell'utente)
Importante
Se vengono rimosse voci o voci nella redirections.xml, il contenuto o le cartelle rimangono nel disco rigido virtuale (x). Qualsiasi elemento aggiunto nella redirections.xml viene inserito nella cartella local_%username%
, ma ciò che esiste già nel VHD(x) non viene rimosso dal disco rigido virtuale(x).
Contenuto del file XML
Il file redirections.xml è composto dalla dichiarazione XML, tre (3) elementi e due (2). La dichiarazione XML è standard e non deve essere modificata.
Elementi e attributi
- FrxProfileFolderRedirection: questo è il primo elemento del file XML e deve essere utilizzato una sola volta.
ExcludeCommonFolders: questo attributo definisce quali cartelle note (se presenti) devono essere reindirizzate dal contenitore del profilo dell'utente. Questo attributo accetta un valore di maschera di bit che indica a FSLogix quale combinazione di cartelle escludere. Aggiungere i valori per tutte le cartelle da escludere. Ad esempio, il valore 7 esclude le cartelle Contatti, Desktop e Documenti.
- 1: cartella Contatti
- 2: Cartella desktop
- 4: Cartella documenti
- 8: Cartella download
- 16: Cartella collegamenti
- 32: Cartelle musicali
- 64: Cartelle immagini e video
- 128: Cartelle coinvolte nei processi a basso livello di integrità, ad esempio AppData\LocalLow
Escludi: questo elemento viene utilizzato per una raccolta di elementi annidati
Exclude
.- Escludi: questo elemento descrive una singola posizione da escludere dal contenitore dell'utente. Il percorso usato in questi elementi deve esistere nel percorso del profilo dell'utente (
%userprofile%
). Il percorso non deve includere laC:\Users\%username%
parte del percorso.- Copia: questo attributo definisce il modo in cui FSLogix gestisce i file e le cartelle durante il reindirizzamento. L'attributo può essere omesso dall'elemento che corrisponde all'uso di un valore pari a 0.
- 0: crea una cartella vuota nella
local_%username%
directory. Nessun file viene copiato durante l'operazione. La copia 0 è il valore più comune usato per ridurre il contenuto del profilo di un utente. Tutti i dati già presenti nel contenitore nella posizione non vengono rimossi. Solo i dati futuri vengono creati nellalocal_%username%
cartella durante la sessione dell'utente e rimossi alla disconnessa. - 1: crea la cartella nella
local_%username%
directory E copia i file FROM il percorso specificato. I dati nel contenitore vengono copiati nellalocal_%username%
cartella e tutti i nuovi dati vengono scritti anche in tale percorso. All'utente disconnettersi vienelocal_%username%
rimosso e i nuovi dati andranno persi. N° accesso copia sempre i dati dal contenitore allalocal_%username%
cartella. - 2: Crea la cartella nella
local_%username%
directory E copia i file nel percorso specificato. Viene creata una nuova cartella (vuota) inlocal_%username%
. Durante la sessione dell'utente, i dati sono scritti in tale percorso. Al momento della disconnessione, i dati sono copiati nel contenitore. Non usare questo valore a meno che non venga indirizzato da un tecnico del supporto Tecnico Microsoft. - 3: crea la cartella nella
local_%username%
directory E copia i file FROM e TO il percorso specificato. Questo valore combina gli effetti da 1 e 2. I dati esistenti sono copiati dal contenitore e nellalocal_%username%
cartella . I nuovi dati vengono scritti nellocal_%username%
percorso e alla disconnessione, tutti i dati vengono copiati di nuovo nel contenitore.
- 0: crea una cartella vuota nella
- Copia: questo attributo definisce il modo in cui FSLogix gestisce i file e le cartelle durante il reindirizzamento. L'attributo può essere omesso dall'elemento che corrisponde all'uso di un valore pari a 0.
- Escludi: questo elemento descrive una singola posizione da escludere dal contenitore dell'utente. Il percorso usato in questi elementi deve esistere nel percorso del profilo dell'utente (
Include: questo elemento viene usato per una raccolta di elementi annidati
Include
.- Include: questo elemento viene usato per garantire che una sottodirectory di un percorso di esclusione venga mantenuta nel contenitore. Il valore COPY non viene usato in questi elementi. Il percorso usato in questi elementi deve esistere nel percorso del profilo dell'utente (
%userprofile%
). Il percorso non deve includere laC:\Users\%username%
parte del percorso.
Nota
- La cartella o i dati devono esistere nel profilo da includere nuovamente nel contenitore. Ad esempio, i nuovi profili che usano FSLogix con un'istruzione di inclusione potrebbero non avere tutte le strutture di cartelle create per un percorso specifico perché l'utente non ha mai usato l'applicazione nel contesto del contenitore del profilo FSLogix.
- La cartella padre di un percorso di cartella incluso DEVE esistere nel contenitore affinché l'inclusione funzioni correttamente.
- Il file XML accetterà un numero qualsiasi di
Include
elementi eExclude
.
- Include: questo elemento viene usato per garantire che una sottodirectory di un percorso di esclusione venga mantenuta nel contenitore. Il valore COPY non viene usato in questi elementi. Il percorso usato in questi elementi deve esistere nel percorso del profilo dell'utente (
Redirections.xml di esempio
Importante
In questo esempio viene illustrato come usare gli elementi. Seguire l'esercitazione Creare e implementare redirections.xml per un'implementazione XML reale. Esclues e include possono avere conseguenze impreviste e devono essere create con cura.
- Escludere le cartelle note (Contatti, Collegamenti e Musica)
- Escludere l'app Contoso Sales, copiando tutti i dati dal contenitore alla
local_%username%
cartella e di nuovo nel contenitore al momento della disconnessa. L'istruzione exclude con copia sposta l'I/O dei dati nel disco locale anziché nel contenitore1. - Escludere la cartella Microsoft Edge senza alcuna operazione di copia (tutti i dati vengono rimossi alla disconnessa).
- Includi la
User Data
cartella all'interno della cartella Microsoft Edge esclusa.
1 I/O è ancora necessario per copiare i dati.
<?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>
Nota
- In Windows 8 e versioni successive, le cartelle coinvolte nei processi a basso livello di integrità vengono sempre reindirizzate alla
local_%username%
directory. - Se la stessa cartella viene specificata in entrambi
Exclude
gli elementi eInclude
, avràExclude
la precedenza. - Per elencare i reindirizzamenti inseriti da FSLogix, usare l'utilità della riga di comando frx.