Condividi tramite

Informazioni di riferimento sullo schema del modello di applicazione per UE-V 2.1 SP1

  • Articolo

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 usa i modelli di percorso delle impostazioni XML per definire le impostazioni dell'applicazione desktop e le impostazioni di Windows acquisite e applicate da UE-V. UE-V include un set di modelli di percorso delle impostazioni predefinite. È anche possibile creare modelli di posizione delle impostazioni personalizzate con il generatore UE-V.

Un utente avanzato può personalizzare il file XML per un modello di percorso delle impostazioni. Questo articolo illustra in dettaglio la struttura XML dei modelli di percorso delle impostazioni UE-V 2.1 SP1 e fornisce indicazioni per la modifica di questi file.

Informazioni di riferimento sullo schema del modello di applicazione UE-V 2.1 SP1

Questa sezione descrive in dettaglio la struttura XML del modello di percorso delle impostazioni UE-V 2.1 SP1 e fornisce indicazioni per la modifica di questo file.

Dichiarazione XML e attributo di codifica

Obbligatorio: True

Tipo: Stringa

La dichiarazione XML deve specificare l'attributo XML versione 1.0 (<?xml version="1.0">). I modelli di posizione delle impostazioni creati dal generatore UE-V vengono salvati nella codifica UTF-8, anche se la codifica non è specificata in modo esplicito. È consigliabile includere l'attributo encoding="UTF-8" in questo elemento come procedura consigliata. Tutti i modelli inclusi nel prodotto specificano anche questo tag. Per informazioni di riferimento, vedere i documenti in %ProgramFiles%\Microsoft User Experience Virtualization\Templates.

Ad esempio:

<?xml version="1.0" encoding="UTF-8"?>

Spazio dei nomi e elemento radice

Obbligatorio: True

Tipo: Stringa

UE-V usa lo https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate spazio dei nomi per tutte le applicazioni. SettingsLocationTemplate è l'elemento radice e contiene tutti gli altri elementi. Fare riferimento SettingsLocationTemplate a tutti i modelli usando questo tag:

<SettingsLocationTemplate xmlns='https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate'>

Tipi di dati

Questi elementi sono i tipi di dati per lo schema del modello di applicazione UE-V.

  • GUID: GUID descrive un'espressione regolare di identificatore univoco globale (GUID) standard (regex) nel formato \{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}. Questo GUID viene usato nell'elemento Filesetting\Root\KnownFolder per verificare la formattazione di cartelle note.

  • FilenameString: FilenameString fa riferimento al nome file di un processo da monitorare. L'espressione regolare seguente limita i relativi valori: [^\\\?\*\|<>/:]+. In altre parole, non possono contenere i caratteri seguenti:

    • Caratteri barra rovesciata (\)
    • Asterisco (*)
    • Punto interrogativo (?)
    • Carattere pipe (|)
    • Segno maggiore di (>)
    • Segno minore di (<)
    • Barra in avanti (/)
    • Due punti (:)

  • IDString: IDString fa riferimento al valore ID degli elementi Application, SettingsLocationTemplate e Common (usato per descrivere i gruppi di applicazioni che condividono le impostazioni comuni). È limitato dalla stessa espressione regex di FilenameString ([^\\\?\*\|<>/:]+).

  • TemplateVersion: TemplateVersion è un valore intero usato per descrivere la revisione del modello di percorso delle impostazioni. Il valore può variare da 0 a 2147483647.

  • Vuoto: Vuoto fa riferimento a un valore Null. Questi dati vengono usati in Process\ShellProcess per indicare che non è presente alcun processo da monitorare. Questo valore non deve essere usato in alcun modello di applicazione.

  • Autore: il tipo di dati Author è un tipo complesso che identifica l'autore di un modello. Contiene due elementi figlio: Name e Email. All'interno del tipo di dati Author, l'elemento Name è obbligatorio mentre l'elemento Email è facoltativo. Questo tipo è descritto in modo più dettagliato nell'elemento SettingsLocationTemplate.

  • Intervallo: l'intervallo definisce una classe integer costituita da due elementi figlio: Minimum e Maximum. Questo tipo di dati viene implementato nel tipo di dati ProcessVersion. Se specificato, è necessario includere i valori Minimo e Massimo.

  • ProcessVersion: ProcessVersion definisce un tipo con quattro elementi figlio: Major, Minor, Build e Patch. Questo tipo di dati viene usato dall'elemento Process per popolare i valori ProductVersion e FileVersion. I dati per questo tipo sono un valore Range. L'elemento figlio Principale è obbligatorio e gli altri sono facoltativi.

  • Architettura: l'architettura enumera due valori possibili: Win32 e Win64. Questi valori vengono usati per specificare l'architettura del processo.

  • Processo: il tipo di dati Process è un contenitore usato per descrivere i processi da monitorare per UE-V. Contiene sei elementi figlio: Filename, Architecture, ProductName, FileDescription, ProductVersion e FileVersion. Questa tabella descrive in dettaglio il rispettivo tipo di dati di ogni elemento:

Elemento Tipo di dati Mandatory
Filename FilenameString True
Architecture Architecture False
ProductName Stringa False
FileDescription Stringa False
ProductVersion ProcessVersion False
FileVersion ProcessVersion False

  • Processi: il tipo di dati Processi rappresenta un contenitore per una raccolta di uno o più elementi Process. Nel tipo di sequenza Processi sono supportati due elementi figlio: Process e ShellProcess. Process è un elemento di tipo Process e ShellProcess è di tipo di dati Empty. Nella sequenza deve essere identificato almeno un elemento.

  • Percorso: il percorso viene utilizzato da RegistrySetting e FileSetting per fare riferimento ai percorsi del Registro di sistema e dei file. Questo elemento supporta due attributi facoltativi: Recursive e DeleteIfNotFound. Entrambi i valori sono impostati su default="False".

    Recursive indica che il percorso e tutte le sottocartelle sono incluse per le impostazioni dei file o che tutte le chiavi figlio del Registro di sistema sono incluse per le impostazioni del Registro di sistema. In entrambi i casi, tutti gli elementi a livello corrente sono inclusi nei dati acquisiti. Per un oggetto FileSettings, tutti i file all'interno della cartella specificata sono inclusi nei dati acquisiti da UE-V, ma le cartelle non sono incluse. Per i percorsi del Registro di sistema, tutti i valori nel percorso corrente vengono acquisiti, ma le chiavi del Registro di sistema figlio non vengono acquisite. In entrambi i casi, è necessario prestare attenzione per evitare di acquisire set di dati di grandi dimensioni o un numero elevato di elementi.

    L'attributo DeleteIfNotFound rimuove l'impostazione dai dati del percorso di archiviazione delle impostazioni dell'utente. Questo attributo può essere utile nei casi in cui la rimozione di queste impostazioni dal pacchetto consente di risparmiare una grande quantità di spazio su disco nel file server del percorso di archiviazione delle impostazioni.

  • FileMask: FileMask specifica solo determinati tipi di file per la cartella definita dall'attributo Path. Ad esempio, Path potrebbe essere C:\users\username\files e FileMask potrebbe *.txt includere solo file di testo.

  • RegistrySetting: RegistrySetting rappresenta un contenitore per le chiavi e i valori del Registro di sistema e il comportamento desiderato associato da parte dell'agente UE-V. All'interno di questo tipo vengono definiti quattro elementi figlio: Path, Name, Exclude e una sequenza dei valori Path e Name.

  • FileSetting: FileSetting contiene parametri associati a file e percorsi di file. Vengono definiti quattro elementi figlio: Root, Path, FileMask ed Exclude. Root è obbligatorio e gli altri sono facoltativi.

  • Impostazioni: l'attributo Settings è un contenitore per tutte le impostazioni che si applicano a un modello specifico. Contiene le istanze delle impostazioni Registro di sistema, File, SystemParameter e CustomAction descritte in precedenza. Inoltre, può contenere anche gli elementi figlio seguenti con i comportamenti descritti:

Elemento Descrizione
Asincrona I pacchetti di impostazioni asincroni vengono applicati senza bloccare l'avvio dell'applicazione in modo che l'avvio dell'applicazione continui mentre le impostazioni vengono ancora applicate. Questo elemento è utile per le impostazioni che possono essere applicate in modo asincrono, ad esempio quelle get/set tramite un'API, ad esempio SystemParameterSetting.
PreventOverlappingSynchronization Per impostazione predefinita, UE-V salva le impostazioni per un'applicazione solo quando viene chiusa l'ultima istanza di un'applicazione che usa il modello. Quando questo elemento è impostato su false, UE-V esporta le impostazioni anche se sono in esecuzione altre istanze di un'applicazione. I modelli adatti, ovvero quelli che includono una sezione Elemento comune, forniti con UE-V, usano questo flag per consentire alle impostazioni condivise di esportare sempre alla chiusura dell'applicazione, impedendo al tempo stesso alle impostazioni specifiche dell'applicazione di esportare fino alla chiusura dell'ultima istanza.
AlwaysApplySettings Questo parametro forza l'applicazione di un pacchetto di impostazioni importato anche se non esistono differenze tra il pacchetto e lo stato corrente dell'applicazione. Questo parametro deve essere usato solo in casi speciali perché può rallentare l'importazione delle impostazioni.

Elemento Name

Obbligatorio: True

Tipo: Stringa

Name specifica un nome univoco per il modello di percorso delle impostazioni. Viene usato a scopo di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi ed debug. In generale, evitare di fare riferimento alle informazioni sulla versione, in quanto questo può essere oggetto dell'elemento ProductVersion. Ad esempio, specificare <Name>My Application</Name> anziché <Name>My Application 1.1</Name>.

Nota

UE-V non fa riferimento a DTD esterni, quindi non è possibile usare entità denominate in un modello di percorso delle impostazioni. Ad esempio, non usare &reg; per fare riferimento al segno di marchio registrato (®). Usare invece riferimenti numerato canonici per includere questi tipi di caratteri speciali, ad esempio per &#174 il carattere del marchio registrato (®). Questa regola si applica a tutti i valori stringa in questo documento.

Per un elenco completo delle entità carattere, vedere W3 XHTML 1.0 - DTD. I documenti con codifica UTF-8 possono includere direttamente i caratteri Unicode. Il salvataggio dei modelli tramite il generatore UE-V converte automaticamente le entità carattere nelle relative rappresentazioni Unicode.

Elemento ID

Obbligatorio: True

Tipo: Stringa

L'ID popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dall'agente UE-V per fare riferimento al modello in fase di esecuzione( ad esempio, vedere l'output dei cmdlet di PowerShell Get-UevTemplate e Get-UevTemplateProgram). Per convenzione, questo tag non deve contenere spazi, il che semplifica lo scripting. I numeri di versione delle applicazioni devono essere specificati in questo elemento per consentire una facile identificazione del modello, ad <ID>MicrosoftCalculator6</ID> esempio o <ID>MicrosoftOffice2010Win64</ID>.

Elemento Version

Obbligatorio: True

Tipo: Integer

Valore minimo: 0

Valore massimo: 2147483647

Version identifica la versione del modello di percorso delle impostazioni per il rilevamento amministrativo delle modifiche. Il generatore UE-V incrementa automaticamente questo numero di uno ogni volta che il modello viene salvato. Si noti che questo campo deve essere un numero intero; i valori frazionari, ad <Version>2.5</Version> esempio non sono consentiti.

Suggerimento

È possibile salvare note sulle modifiche della versione usando tag <!-- -->di commento XML , ad esempio:

  <!--
     Version History

     Version 1 Jul 05, 2012 Initial template created by Generator - Denise@Contoso.com
     Version 2 Jul 31, 2012 Added support for app.exe v2.1.3 - Mark@Contoso.com
     Version 3 Jan 01, 2013 Added font settings support - Mark@Contoso.com
     Version 4 Jan 31, 2013 Added support for plugin settings - Tony@Contoso.com
   -->
  <Version>4</Version>

Importante

Viene eseguita una query su questo valore per determinare se una nuova versione di un modello deve essere applicata a un modello esistente in queste istanze:

  • Quando viene eseguita l'attività di aggiornamento automatico del modello pianificata.

  • Quando viene eseguito il cmdlet Update-UevTemplate PowerShell.

  • Quando il microsoft\uev:SettingsLocationTemplate metodo Update viene chiamato tramite WMI.

Elemento Author

Obbligatorio: False

Tipo: Stringa

Autore identifica l'autore del modello di posizione delle impostazioni. Sono supportati due elementi figlio facoltativi: Nome e Email. Entrambi gli attributi sono facoltativi, ma, se l'elemento figlio Email è specificato, deve essere accompagnato dall'elemento Name. L'autore fa riferimento al nome completo del contatto per il modello di posizione delle impostazioni e il messaggio di posta elettronica deve fare riferimento a un indirizzo di posta elettronica per l'autore. È consigliabile includere queste informazioni nei modelli pubblicati pubblicamente.

Processi e elemento di processo

Obbligatorio: True

Tipo: elemento

L'elemento Processes contiene almeno un <Process> elemento, che a sua volta contiene gli elementi figlio seguenti: Filename, Architecture, ProductName, FileDescription, ProductVersion e FileVersion. L'elemento figlio Filename è obbligatorio e gli altri sono facoltativi. Un elemento completamente popolato contiene tag simili a questo esempio:

<Process>
  <Filename>MyApplication.exe</Filename>
  <Architecture>Win64</Architecture>
  <ProductName> MyApplication </ProductName>
  <FileDescription>MyApplication.exe</FileDescription>
  <ProductVersion>
    <Major Minimum="2" Maximum="2" />
    <Minor Minimum="0" Maximum="0" />
    <Build Minimum="0" Maximum="0" />
    <Patch Minimum="5" Maximum="5" />
  </ProductVersion>
  <FileVersion>
    <Major Minimum="2" Maximum="2" />
    <Minor Minimum="0" Maximum="0" />
    <Build Minimum="0" Maximum="0" />
    <Patch Minimum="5" Maximum="5" />
  </FileVersion>
</Process>

Filename

Obbligatorio: True

Tipo: Stringa

Il nome file fa riferimento al nome di file effettivo del file eseguibile come viene visualizzato nel file system. Questo elemento specifica il criterio primario usato da UE-V per valutare se un modello si applica o meno a un processo. Questo elemento deve essere specificato nel file XML del modello di percorso delle impostazioni.

I nomi file validi non possono corrispondere all'espressione regolare seguente: [^\\\?\*\|<>/:]+. In altre parole, non possono contenere i caratteri seguenti:

  • Caratteri barra rovesciata (\)
  • Asterisco (*)
  • Punto interrogativo (?)
  • Carattere pipe (|)
  • Segno maggiore di (>)
  • Segno minore di (<)
  • Barra in avanti (/)
  • Due punti (:)

Suggerimento

Per testare una stringa in base a questa espressione regolare, usare una finestra di comando di PowerShell e sostituire il nome del file eseguibile con YourFileName:

"YourFileName.exe" -match "[\\\?\*\|<>/:]+"

Il valore True indica che la stringa contiene caratteri non validi. Ecco alcuni esempi di valori non validi:

  • \\server\share\program.exe

  • Program*.exe

  • Pro?ram.exe

  • Program<1>.exe

Nota

Il generatore UE-V codifica rispettivamente i caratteri maggiore e minore di come &gt; e &lt; .

In rari casi, il valore FileName non include necessariamente l'estensione .exe, ma deve essere specificato come parte del valore. Ad esempio, <Filename>MyApplictication.exe</Filename> deve essere specificato invece di <Filename>MyApplictication</Filename>. Il secondo esempio non applica il modello al processo se il nome effettivo del file eseguibile è MyApplication.exe.

Architecture

Obbligatorio: False

Tipo: Architettura (stringa)

L'architettura si riferisce all'architettura del processore per cui è stato compilato il file eseguibile di destinazione. I valori validi sono Win32 per le applicazioni a 32 bit o Win64 per le applicazioni a 64 bit. Se presente, questo tag limita l'applicabilità del modello di posizione delle impostazioni a una particolare architettura dell'applicazione. Ad esempio, confrontare i %ProgramFiles%\Microsoft User Experience Virtualization\templates\MicrosoftOffice2010Win32.1SP1.xml file e MicrosoftOffice2010Win64.xml inclusi con UE-V. Ciò è utile quando i percorsi relativi cambiano tra versioni diverse di un eseguibile o se le impostazioni vengono aggiunte o rimosse quando si passa da un'architettura del processore a un'altra.

Se questo elemento è assente, il modello di posizione delle impostazioni ignora l'architettura del processo e si applica sia ai processi a 32 bit che a 64 bit se si applicano il nome file e altri attributi.

Nota

UE-V non supporta i processori ARM in questa versione.

ProductName

Obbligatorio: False

Tipo: Stringa

ProductName è un elemento facoltativo usato per identificare un prodotto per scopi amministrativi o per la creazione di report. ProductName differisce da Filename in quanto non esistono restrizioni relative alle espressioni regolari sul relativo valore. Ciò consente descrizioni più facilmente comprensibili di un processo in cui il nome eseguibile non è ovvio. Ad esempio:

<Process>
  <Filename>MyApplication.exe</Filename>
  <ProductName>My Application 6.x by Contoso.com</ProductName>
  <ProductVersion>
    <Major Minimum="6" Maximum="6" />
  </ProductVersion>
</Process>

FileDescription

Obbligatorio: False

Tipo: Stringa

FileDescription è un tag facoltativo che consente una descrizione amministrativa del file eseguibile. Si tratta di un campo di testo libero e può essere utile per distinguere più eseguibili all'interno di un pacchetto software in cui è necessario identificare la funzione del file eseguibile.

Ad esempio, in un'applicazione adatta potrebbe essere utile fornire promemoria sulla funzione di due eseguibili (MyApplication.exe e MyApplicationHelper.exe), come illustrato di seguito:

<Processes>
  <Process>
    <Filename>MyApplication.exe</Filename>
    <FileDescription>My Application Main Engine</ FileDescription>
    <ProductVersion>
      <Major Minimum="6" Maximum="6" />
    </ProductVersion>
  </Process>
  <Process>
    <Filename>MyApplicationHelper.exe</Filename>
    <FileDescription>My Application Background Process Executable</FileDescription>
    <ProductVersion>
      <Major Minimum="6" Maximum="6" />
    </ProductVersion>
  </Process>
</Processes>

ProductVersion

Obbligatorio: False

Tipo: Stringa

ProductVersion fa riferimento alle versioni principali e secondarie di un file, nonché a un livello di compilazione e patch. ProductVersion è un elemento facoltativo, ma, se specificato, deve contenere almeno l'elemento figlio Major. Il valore deve esprimere un intervallo nel formato Minimum="X" Maximum="Y" dove X e Y sono numeri interi. I valori Minimo e Massimo possono essere identici.

Gli elementi della versione del prodotto e del file possono essere lasciati non specificati. In questo modo la versione del modello risulta indipendente, ovvero il modello si applica a tutte le versioni del file eseguibile specificato.

Esempio 1: Versione del prodotto 1.0

Versione del prodotto: 1.0 specificata nel generatore UE-V produce il codice XML seguente:

<ProductVersion>
  <Major Minimum="1" Maximum="1" />
  <Minor Minimum="0" Maximum="0" />
</ProductVersion>

Esempio 2: Versione del prodotto 5.0.2.1000

Versione del file: 5.0.2.1000 specificata nel generatore UE-V produce il codice XML seguente:

<FileVersion>
  <Major Minimum="5" Maximum="5" />
  <Minor Minimum="0" Maximum="0" />
  <Build Minimum="2" Maximum="2" />
  <Patch Minimum="1000" Maximum="1000" />
</FileVersion>

Esempio non corretto 1 - Intervallo incompleto

È presente solo l'attributo Minimum. Il valore massimo deve essere incluso anche in un intervallo.

<ProductVersion>
  <Major Minimum="2" />
</ProductVersion>

Esempio 2 non corretto - Valore secondario specificato senza elemento Major

È presente solo l'elemento Minor. Anche major deve essere incluso.

<ProductVersion>
  <Minor Minimum="0" Maximum="0" />
</ProductVersion>

FileVersion

Obbligatorio: False

Tipo: Stringa

FileVersion distingue tra la versione di versione di un'applicazione pubblicata e i dettagli di compilazione interni di un eseguibile del componente. Per la maggior parte delle applicazioni commerciali, questi numeri sono identici. Laddove variano, la versione del prodotto di un file indica un'identificazione della versione generica di un file, mentre la versione del file indica una compilazione specifica di un file (come in un hotfix o un aggiornamento). In questo modo vengono identificati in modo univoco i file senza interrompere la logica di rilevamento.

Per determinare la versione del prodotto e la versione del file di un file eseguibile specifico, fare clic con il pulsante destro del mouse sul file in Esplora risorse, selezionare Proprietà e quindi selezionare nella scheda Dettagli.

L'inclusione di un elemento FileVersion per un'applicazione consente una logica di rilevamento di ottimizzazione più granulare, ma non è necessaria per la maggior parte delle applicazioni. Le impostazioni dell'elemento ProductVersion vengono controllate prima e quindi fileVersion viene controllato. Si applica l'impostazione più restrittiva.

Gli elementi figlio e le regole di sintassi per FileVersion sono identici a quelli di ProductVersion.

<Process>
  <Filename>MSACCESS.EXE</Filename>
  <Architecture>Win32</Architecture>
  <ProductVersion>
    <Major Minimum="14" Maximum="14" />
    <Minor Minimum="0" Maximum="0" />
  </ProductVersion>
  <FileVersion>
    <Major Minimum="14" Maximum="14" />
    <Minor Minimum="0" Maximum="0" />
  </FileVersion>
</Process>

Elemento Application

L'applicazione è un contenitore per le impostazioni che si applicano a una particolare applicazione. Si tratta di una raccolta dei campi/tipi seguenti.

Campo/Tipo Descrizione
Name Specifica un nome univoco per il modello di percorso delle impostazioni. Viene usato a scopo di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi ed debug. Per altre informazioni, vedere Nome.
ID Popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dall'agente UE-V per fare riferimento al modello in fase di esecuzione. Per altre informazioni, vedere ID.
Descrizione Descrizione facoltativa del modello.
LocalizedNames Nome facoltativo visualizzato nell'interfaccia utente, localizzato in base alle impostazioni locali della lingua.
LocalizedDescriptions Descrizione del modello facoltativa localizzata in base alle impostazioni locali della lingua.
Versione Identifica la versione del modello di percorso delle impostazioni per il rilevamento amministrativo delle modifiche. Per altre informazioni, vedere Versione.
DeferToMSAccount Controlla se questo modello è abilitato o meno con un account Microsoft. Se la sincronizzazione msa è abilitata per un utente in un computer, questo modello viene automaticamente disabilitato.
DeferToOffice365 Analogamente a MSA, questo controllo controlla se questo modello è abilitato con Office365. Se Office 365 viene usato per sincronizzare le impostazioni, questo modello viene disabilitato automaticamente.
FixedProfile Specifica che questo modello può essere associato solo al profilo specificato all'interno di questo elemento e non può essere modificato tramite WMI o PowerShell.
Processi Contenitore per una raccolta di uno o più elementi Process. Per altre informazioni, vedere Processi.
Impostazioni Contenitore per tutte le impostazioni applicabili a un modello specifico. Contiene le istanze delle impostazioni Registro di sistema, File, SystemParameter e CustomAction. Per altre informazioni, vedere Impostazioni nei tipi di dati.

Elemento comune

Common è simile a un elemento Application, ma è sempre associato a due o più elementi Application. La sezione Common rappresenta il set di impostazioni condivise tra tali istanze dell'applicazione. Si tratta di una raccolta dei campi/tipi seguenti.

Campo/Tipo Descrizione
Name Specifica un nome univoco per il modello di percorso delle impostazioni. Viene usato a scopo di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi ed debug. Per altre informazioni, vedere Nome.
ID Popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dall'agente UE-V per fare riferimento al modello in fase di esecuzione. Per altre informazioni, vedere ID.
Descrizione Descrizione facoltativa del modello.
LocalizedNames Nome facoltativo visualizzato nell'interfaccia utente, localizzato in base alle impostazioni locali della lingua.
LocalizedDescriptions Descrizione del modello facoltativa localizzata in base alle impostazioni locali della lingua.
Versione Identifica la versione del modello di percorso delle impostazioni per il rilevamento amministrativo delle modifiche. Per altre informazioni, vedere Versione.
DeferToMSAccount Controlla se questo modello è abilitato o meno con un account Microsoft. Se la sincronizzazione msa è abilitata per un utente in un computer, questo modello viene automaticamente disabilitato.
DeferToOffice365 Analogamente a MSA, questo controllo controlla se questo modello è abilitato con Office365. Se Office 365 viene usato per sincronizzare le impostazioni, questo modello viene disabilitato automaticamente.
FixedProfile Specifica che questo modello può essere associato solo al profilo specificato all'interno di questo elemento e non può essere modificato tramite WMI o PowerShell.
Impostazioni Contenitore per tutte le impostazioni applicabili a un modello specifico. Contiene le istanze delle impostazioni Registro di sistema, File, SystemParameter e CustomAction. Per altre informazioni, vedere Impostazioni nei tipi di dati.

Elemento SettingsLocationTemplate

Questo elemento definisce le impostazioni per una singola applicazione o una suite di applicazioni.

Campo/Tipo Descrizione
Name Specifica un nome univoco per il modello di percorso delle impostazioni. Viene usato a scopo di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi ed debug. Per altre informazioni, vedere Nome.
ID Popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dall'agente UE-V per fare riferimento al modello in fase di esecuzione. Per altre informazioni, vedere ID.
Descrizione Descrizione facoltativa del modello.
LocalizedNames Nome facoltativo visualizzato nell'interfaccia utente, localizzato in base alle impostazioni locali della lingua.
LocalizedDescriptions Descrizione del modello facoltativa localizzata in base alle impostazioni locali della lingua.

Appendice: SettingsLocationTemplate.xsd

Ecco il file SettingsLocationTemplate.xsd che mostra i relativi elementi, elementi figlio, attributi e parametri:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema id="UevSettingsLocationTemplate"
  targetNamespace="https://schemas.microsoft.com/UserExperienceVirtualization/2013A/SettingsLocationTemplate"
  elementFormDefault="qualified"
  xmlns="https://schemas.microsoft.com/UserExperienceVirtualization/2013A/SettingsLocationTemplate"
  xmlns:mstns="https://schemas.microsoft.com/UserExperienceVirtualization/2013A/SettingsLocationTemplate"
  xmlns:xs="http://www.w3.org/2001/XMLSchema">

    <xs:simpleType name="Guid">
        <xs:restriction base="xs:string">
            <xs:pattern value="\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="FilenameString">
        <xs:restriction base="xs:string">
            <xs:pattern value="[^\\\?\*\|&lt;&gt;/:]+" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="IDString">
        <xs:restriction base="xs:string">
            <xs:pattern value="[^\\\?\*\|&lt;&gt;/:.]+" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="CompositeIDString">
        <xs:restriction base="xs:string">
            <xs:pattern value="[^\\\?\*\|&lt;&gt;/:.]+([.][^\\\?\*\|&lt;&gt;/:.]+)?" />
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="TemplateVersion">
        <xs:restriction base="xs:integer">
            <xs:minInclusive value="0" />
            <xs:maxInclusive value="2147483647" />
        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="Empty">
        <xs:sequence/>
    </xs:complexType>

    <xs:complexType name="LocalizedString">
        <xs:simpleContent>
            <xs:extension base="xs:string">
                <xs:attribute name="Locale" type="xs:string" use="required"/>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>

    <xs:complexType name="LocalizedName">
        <xs:sequence>
            <xs:element name="Name" type="LocalizedString" minOccurs="1" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="LocalizedDescription">
        <xs:sequence>
            <xs:element name="Description" type="LocalizedString" minOccurs="1" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="ReplacedTemplates">
      <xs:sequence>
        <xs:element name="ID" type="CompositeIDString" minOccurs="1" maxOccurs="unbounded" />
    </xs:sequence>
    </xs:complexType>

    <xs:complexType name="Author">
        <xs:all>
            <xs:element name="Name" type="xs:string" minOccurs="1" />
            <xs:element name="Email" type="xs:string" minOccurs="0" />
        </xs:all>
    </xs:complexType>

    <xs:complexType name="Range">
        <xs:attribute name="Minimum" type="xs:integer" use="required"/>
        <xs:attribute name="Maximum" type="xs:integer" use="required"/>
    </xs:complexType>

    <xs:complexType name="ProcessVersion">
        <xs:sequence>
            <xs:element name="Major" type="Range" minOccurs="1" />
            <xs:element name="Minor" type="Range" minOccurs="0" />
            <xs:element name="Build" type="Range" minOccurs="0" />
            <xs:element name="Patch" type="Range" minOccurs="0" />
        </xs:sequence>
    </xs:complexType>

    <xs:simpleType name="Architecture">
        <xs:restriction base="xs:string">
            <xs:enumeration value="Win32"/>
            <xs:enumeration value="Win64"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="Process">
        <xs:sequence>
            <xs:element name="Filename" type="FilenameString" minOccurs="1" />
            <xs:element name="Architecture" type="Architecture" minOccurs="0" />
            <xs:element name="ProductName" type="xs:string" minOccurs="0" />
            <xs:element name="FileDescription" type="xs:string" minOccurs="0" />
            <xs:element name="ProductVersion" type="ProcessVersion" minOccurs="0" maxOccurs="unbounded"/>
            <xs:element name="FileVersion" type="ProcessVersion" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="Processes">
        <xs:sequence>
            <xs:choice minOccurs="1">
                <xs:element name="Process" type="Process" />
                <xs:element name="ShellProcess" type="Empty" />
            </xs:choice>
            <xs:element name="Process" type="Process" minOccurs="0" maxOccurs="unbounded" />
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="Path">
        <xs:simpleContent>
            <xs:extension base="xs:string">
                <xs:attribute name="Recursive" type="xs:boolean" default="false"/>
                <xs:attribute name="DeleteIfNotFound" type="xs:boolean" default="false"/>
            </xs:extension>
        </xs:simpleContent>
    </xs:complexType>

    <xs:complexType name="RegistrySetting">
        <xs:sequence>
            <xs:element name="Path" type="Path" />
            <xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
            <xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="Path" type="Path" minOccurs="0" />
                        <xs:element name="Name" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
                    </xs:sequence>
                </xs:complexType>
            </xs:element>
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="FileSetting">
        <xs:sequence>

            <xs:element name="Root">
                <xs:complexType>
                    <xs:choice>
                        <xs:element name="KnownFolder" type="Guid" />
                        <xs:element name="RegistryEntry" type="xs:string" />
                        <xs:element name="EnvironmentVariable" type="xs:string" />
                    </xs:choice>
                </xs:complexType>
            </xs:element>

            <xs:element name="Path" minOccurs="0" type="Path" />
            <xs:element name="FileMask" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>

            <xs:element name="Exclude" minOccurs="0" maxOccurs="unbounded">
                <xs:complexType>
                    <xs:sequence>
                        <xs:element name="Path" type="Path" minOccurs="0" />
                        <xs:element name="FileMask" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
                    </xs:sequence>
                </xs:complexType>
            </xs:element>

        </xs:sequence>
    </xs:complexType>

    <xs:simpleType name="CustomActionSetting">
        <xs:restriction base="xs:anyURI"/>
    </xs:simpleType>

    <xs:simpleType name="SystemParameterSetting">
        <xs:restriction base="xs:string">

            <!-- Accessibility parameters -->
            <xs:enumeration value="AccessTimeout"/>
            <xs:enumeration value="AudioDescription"/>
            <xs:enumeration value="ClientAreaAnimation"/>
            <xs:enumeration value="DisableOverlappedContent"/>
            <xs:enumeration value="FilterKeys"/>
            <xs:enumeration value="FocusBorderHeight"/>
            <xs:enumeration value="FocusBorderWidth"/>
            <xs:enumeration value="HighContrast"/>
            <xs:enumeration value="MessageDuration"/>
            <xs:enumeration value="MouseClickLock"/>
            <xs:enumeration value="MouseClickLockTime"/>
            <xs:enumeration value="MouseKeys"/>
            <xs:enumeration value="MouseSonar"/>
            <xs:enumeration value="MouseVanish"/>
            <xs:enumeration value="ScreenReader"/>
            <xs:enumeration value="ShowSounds"/>
            <xs:enumeration value="SoundSentry"/>
            <xs:enumeration value="StickyKeys"/>
            <xs:enumeration value="ToggleKeys"/>

            <!-- Input parameters -->
            <xs:enumeration value="Beep"/>
            <xs:enumeration value="BlockSendInputResets"/>
            <xs:enumeration value="DefaultInputLang"/>
            <xs:enumeration value="DoubleClickTime"/>
            <xs:enumeration value="DoubleClkHeight"/>
            <xs:enumeration value="DoubleClkWidth"/>
            <xs:enumeration value="KeyboardCues"/>
            <xs:enumeration value="KeyboardDelay"/>
            <xs:enumeration value="KeyboardPref"/>
            <xs:enumeration value="KeyboardSpeed"/>
            <xs:enumeration value="Mouse"/>
            <xs:enumeration value="MouseButtonSwap"/>
            <xs:enumeration value="MouseHoverHeight"/>
            <xs:enumeration value="MouseHoverTime"/>
            <xs:enumeration value="MouseHoverWidth"/>
            <xs:enumeration value="MouseSpeed"/>
            <xs:enumeration value="MouseTrails"/>
            <xs:enumeration value="SnapToDefButton"/>
            <xs:enumeration value="WheelScrollChars"/>
            <xs:enumeration value="WheelScrollLines"/>

            <!-- Desktop parameters (limited subset) -->
            <xs:enumeration value="DeskWallpaper"/>
            <xs:enumeration value="DesktopColor"/>

        </xs:restriction>
    </xs:simpleType>

    <xs:complexType name="Settings">
        <xs:sequence>
            <xs:element name="Asynchronous" type="xs:boolean" minOccurs="0" />
            <xs:element name="PreventOverlappingSynchronization" type="xs:boolean" minOccurs="0" />
            <xs:element name="AlwaysApplySettings" type="xs:boolean" minOccurs="0" />
            <xs:choice minOccurs="0" maxOccurs="unbounded">
                <xs:element name="Registry" type="RegistrySetting" />
                <xs:element name="File" type="FileSetting" />
                <xs:element name="SystemParameter" type="SystemParameterSetting" />
                <xs:element name="CustomAction" type="CustomActionSetting" />
            </xs:choice>
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="Common">
        <xs:sequence>
            <xs:element name="Name" type="xs:string" />
            <xs:element name="ID" type="IDString" />
            <xs:element name="ReplacedTemplates" type="ReplacedTemplates" minOccurs="0" />
            <xs:element name="Description" type="xs:string" minOccurs="0" />
            <xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
            <xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
            <xs:element name="Version" type="xs:integer" />
            <xs:element name="DeferToMSAccount" type="Empty"  minOccurs="0" />
            <xs:element name="DeferToOffice365" type="Empty" minOccurs="0" />
            <xs:element name="Settings" type="Settings" />
        </xs:sequence>
    </xs:complexType>

    <xs:complexType name="Application">
        <xs:sequence>
            <xs:element name="Name" type="xs:string" />
            <xs:element name="ID" type="IDString" />
            <xs:element name="ReplacedTemplates" type="ReplacedTemplates" minOccurs="0" />
            <xs:element name="Description" type="xs:string" minOccurs="0" />
            <xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
            <xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />
            <xs:element name="Version" type="xs:integer" />
            <xs:element name="DeferToMSAccount" type="Empty"  minOccurs="0" />
            <xs:element name="DeferToOffice365" type="Empty" minOccurs="0" />
            <xs:element name="Processes" type="Processes" />
            <xs:element name="Settings" type="Settings" />
        </xs:sequence>
    </xs:complexType>


    <xs:element name="SettingsLocationTemplate">
        <xs:complexType>
            <xs:sequence>

                <xs:element name="Name" type="xs:string" />
                <xs:element name="ID" type="IDString" />
                <xs:element name="Description" type="xs:string" minOccurs="0" />
                <xs:element name="LocalizedNames" type="LocalizedName" minOccurs="0" />
                <xs:element name="LocalizedDescriptions" type="LocalizedDescription" minOccurs="0" />

                <xs:choice>

                    <!-- Single application -->
                    <xs:sequence>
                        <xs:element name="ReplacedTemplates" type="ReplacedTemplates" minOccurs="0" />
                        <xs:element name="Version" type="TemplateVersion" />
                        <xs:element name="Author" type="Author" minOccurs="0" />
                        <xs:element name="FixedProfile" type="xs:string"  minOccurs="0" />
                        <xs:element name="DeferToMSAccount" type="Empty"  minOccurs="0" />
                        <xs:element name="DeferToOffice365" type="Empty" minOccurs="0" />
                        <xs:element name="Processes" type="Processes" />
                        <xs:element name="Settings" type="Settings" />
                    </xs:sequence>

                    <!-- Suite of applications -->
                    <xs:sequence>
                        <xs:element name="ManageSuiteOnly" type="xs:boolean" minOccurs="0" />
                        <xs:element name="Author" type="Author" minOccurs="0" />
                        <xs:element name="FixedProfile" type="xs:string"  minOccurs="0" />
                        <xs:element name="Common" type="Common" />
                        <xs:element name="Application" type="Application" minOccurs="2" maxOccurs="unbounded" />
                    </xs:sequence>

                </xs:choice>

            </xs:sequence>
        </xs:complexType>
    </xs:element>
    <!-- SettingsLocationTemplate -->

</xs:schema>

Uso di modelli UE-V 2.1 SP1 personalizzati e del generatore UE-V 2.1 SP1

Riferimento tecnico per UE-V 2.1 SP1