Informazioni di riferimento sullo schema del modello di applicazione per UE-V (Windows 10)
User Experience Virtualization (UE-V) usa i modelli di posizione 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 di modelli UE-V.
Un utente avanzato può personalizzare il file XML per un modello di percorso delle impostazioni. Questo argomento descrive in dettaglio la struttura XML dei modelli di percorso delle impostazioni UE-V e fornisce indicazioni per la modifica di questi file.
Informazioni di riferimento sullo schema del modello di applicazione UE-V
Questa sezione descrive in dettaglio la struttura XML del modello di percorso delle impostazioni UE-V e fornisce indicazioni per la modifica di questo file.
In questa sezione
- Dichiarazione XML e attributo di codifica
- Spazio dei nomi ed elemento radice
- Tipi di dati
- Elemento Name
- Elemento ID
- Elemento Version
- Elemento Author
- Elementi Processes e Process
- Elemento Application
- Elemento Common
- Elemento SettingsLocationTemplate
- Appendice: SettingsLocationTemplate.xsd
Dichiarazione XML e attributo di codifica
Obbligatorio: TrueType: String
La dichiarazione XML deve specificare l'attributo XML versione 1.0 (<?xml version="1.0">). I modelli di posizione delle impostazioni creati dal generatore di modelli 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 (vedere i documenti in %ProgramFiles%\Microsoft User Experience Virtualization\Templates per informazioni di riferimento). Ad esempio:
<?xml version="1.0" encoding="UTF-8"?>
Spazio dei nomi ed elemento radice
Obbligatorio: TrueType: String
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. Impostazioni di riferimentoLocationTemplate in tutti i modelli usando questo tag:
<SettingsLocationTemplate xmlns='https://schemas.microsoft.com/UserExperienceVirtualization/2012/SettingsLocationTemplate'>
Tipi di dati
Questi tipi di dati sono quelli per lo schema del modello di applicazione UE-V.
GUID GUID descrive un'espressione regolare identificatore univoco globale standard 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. I relativi valori sono limitati dalla regex [^\\\?\*\|<>/:]+, ovvero non possono contenere caratteri barra rovesciata, caratteri jolly asterisco o punto interrogativo, il carattere della pipe, il segno maggiore o minore di, la barra o i 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 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. Questo tipo di dati viene usato 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.
Gamma Range 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 da 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 Processes 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. Questa rimozione 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.
Maschera file FileMask specifica solo determinati tipi di file per la cartella definita da 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 del servizio 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 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 impostazioni vengono recuperate/impostate 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 i modelli 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: TrueType: String
Name specifica un nome univoco per il modello di percorso delle impostazioni. Questo nome viene usato per scopi di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi e di debug. In generale, evitare di fare riferimento alle informazioni sulla versione, perché questo riferimento 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 ® per fare riferimento al segno ® di marchio registrato . Usare invece riferimenti numerato canonici per includere questi tipi di caratteri speciali, ad esempio ® per il ® carattere. Questa regola si applica a tutti i valori stringa in questo documento.
Per un elenco completo delle entità carattere, vedere http://www.w3.org/TR/xhtml1/dtds.html . I documenti con codifica UTF-8 possono includere direttamente i caratteri Unicode. Il salvataggio dei modelli tramite il generatore di modelli UE-V converte automaticamente le entità carattere nelle relative rappresentazioni Unicode.
Elemento ID
Obbligatorio: TrueType: String
L'ID popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dal servizio 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>MicrosoftOffice2016Win64</ID>
esempio .
Elemento Version
Obbligatorio: TrueType: IntegerMinimum Value: 0Maximum Value: 2147483647
Version identifica la versione del modello di percorso delle impostazioni per il rilevamento amministrativo delle modifiche. Il generatore di modelli 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 di PowerShell Update-UevTemplate
- Quando il metodo microsoft\uev:SettingsLocationTemplate Update viene chiamato tramite WMI
Elemento Author
Obbligatorio: FalseType: String
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.
Elementi Processes e Process
Obbligatorio: TrueType: Element
I processi contengono 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: TrueType: String
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 devono corrispondere all'espressione regolare [^\\\?\*\|<>/:]+, ovvero non possono contenere caratteri barra rovesciata, caratteri jolly asterisco o punto interrogativo, il carattere della pipe, il segno maggiore o minore di, la barra in avanti o i due punti (i caratteri \ ? * | <> / o : ).
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
- Programma*.exe
- Pro?ram.exe
- Programma<1>.exe
Nota
Il generatore di modelli UE-V codifica rispettivamente i caratteri maggiore e minore di come > e < .
In rari casi, il valore FileName non include necessariamente l'estensione .exe, ma deve essere specificato come parte del valore. Ad esempio, <Filename>MyApplication.exe</Filename>
deve essere specificato invece di <Filename>MyApplication</Filename>
. Il secondo esempio non applica il modello al processo se il nome effettivo del file eseguibile è "MyApplication.exe".
Architecture
Obbligatorio: FalseType: Architecture (String)
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. Per un esempio di questa restrizione di applicabilità, confrontare i file %ProgramFiles%\Microsoft User Experience Virtualization\templates\ MicrosoftOffice2016Win32.xml e MicrosoftOffice2016Win64.xml inclusi in UE-V. Questa restrizione di applicabilità è utile quando i percorsi relativi cambiano tra versioni diverse di un eseguibile o se le impostazioni sono state 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: FalseType: String
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. Questa flessibilità consente descrizioni più facilmente comprensibili di un processo in cui il nome eseguibile potrebbe non essere 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: FalseType: String
FileDescription è un tag facoltativo che consente una descrizione amministrativa del file eseguibile. Questo tag è 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: FalseType: String
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.
È possibile che gli elementi della versione del prodotto e del file non siano specificati. In questo modo il modello diventa "indipendente dalla versione", ovvero il modello verrà applicato a tutte le versioni del file eseguibile specificato.
Esempio 1:
Versione del prodotto: 1.0 specificata nel generatore di modelli UE-V produce il codice XML seguente:
<ProductVersion>
<Major Minimum="1" Maximum="1" />
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
Esempio 2:
Versione del file: 5.0.2.1000 specificata nel generatore di modelli 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 1 non corretto - 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 : specificato come secondario senza elemento Major:
È presente solo l'elemento Minor. Anche major deve essere incluso.
<ProductVersion>
<Minor Minimum="0" Maximum="0" />
</ProductVersion>
FileVersion
Obbligatorio: FalseType: String
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 nell'esempio di un hotfix o di un aggiornamento). Questa versione del file identifica 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 fare clic sulla 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. Verrà applicata l'impostazione più restrittiva.
Gli elementi figlio e le regole di sintassi per FileVersion sono identici agli elementi e alle regole 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. Questo nome viene usato per scopi di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi e di debug. Per altre informazioni, vedere Nome. |
ID | Popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dal servizio 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 insieme a un account Microsoft o meno. Se la sincronizzazione msa è abilitata per un utente in un computer, questo modello verrà automaticamente disabilitato. |
DeferToOffice365 | Analogamente a MSA, questo tipo controlla se questo modello è abilitato in combinazione con Office361. Se Office 365 viene usato per sincronizzare le impostazioni, questo modello verrà automaticamente disabilitato. |
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 Common
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. Questo nome viene usato per scopi di visualizzazione quando si fa riferimento al modello nei log WMI, PowerShell, Visualizzatore eventi e di debug. Per altre informazioni, vedere Nome. |
ID | Popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dal servizio 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 insieme a un account Microsoft o meno. Se la sincronizzazione msa è abilitata per un utente in un computer, questo modello verrà automaticamente disabilitato. |
DeferToOffice365 | Analogamente a MSA, questo tipo controlla se questo modello è abilitato in combinazione con Office361. Se Office 365 viene usato per sincronizzare le impostazioni, questo modello verrà automaticamente disabilitato. |
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. Questo tipo viene usato a scopo di visualizzazione quando si fa riferimento al modello in WMI, PowerShell, Visualizzatore eventi e log di debug. Per altre informazioni, vedere Nome. |
ID | Popola un identificatore univoco per un modello specifico. Questo tag diventa l'identificatore primario usato dal servizio 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="[^\\\?\*\|<>/:]+" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="IDString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:.]+" />
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="CompositeIDString">
<xs:restriction base="xs:string">
<xs:pattern value="[^\\\?\*\|<>/:.]+([.][^\\\?\*\|<>/:.]+)?" />
</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>
Argomenti correlati
Uso di modelli UE-V personalizzati e informazioni di riferimento tecnico sul generatore di modelli UE-Vper UE-V