Informazioni di riferimento sul file Config.xml per Office 2013

 

Si applica a: Office 2013

Ultima modifica dell'argomento: 2016-12-16

Riepilogo: in questo articolo vengono fornite informazioni su come utilizzare il file Config.xml per la personalizzazione delle installazioni di Office 2013 basate su Windows Installer.

Destinatari: professionisti IT

Gli amministratori utilizzano il file Config.xml per eseguire attività di installazione e manutenzione per Office 2013.

Lo strumento principale usato dagli amministratori per personalizzare l'installazione di prodotti basati su Windows Installer in Office 2013 è lo Strumento di personalizzazione di Office. Gli strumenti e i metodi di personalizzazione di Office 2013 sono gli stessi usati per Office 2010 e Office 2007. Per altre informazioni su come usare lo Strumento di personalizzazione di Office per la creazione di un file di configurazione dell'installazione e sulle novità presenti nello strumento in Office 2013, vedere Informazioni di riferimento sullo Strumento di personalizzazione di Office per Office 2013.

Il file Config.xml consente di configurare le attività di installazione e viene utilizzato solo durante l'esecuzione del programma di installazione. Config.xml non viene installato o memorizzato nella cache dei computer degli utenti. Gli amministratori possono modificare il file Config.xml al fine di personalizzare l'installazione. Per impostazione predefinita, il file Config.xml archiviato nella cartella principale del prodotto, core_product_folder_name.WW, indica al programma di installazione di installare il prodotto. Il file Config.xml nella cartella ProPlus.WW consente ad esempio di installare Office Professional Plus 2013.

Il file Config.xml viene utilizzato per eseguire le attività di installazione seguenti:

• Specificare il percorso del punto di installazione di rete.

• Selezionare il prodotto da installare.

• Personalizzare le opzioni di installazione, ad esempio la registrazione e il percorso del file di configurazione dell'installazione e degli aggiornamenti software.

• Impostare le opzioni di installazione, ad esempio il nome dell'utente e dell'azienda.

• Copiare l'origine di installazione locale nel computer dell'utente senza installare Office.

• Aggiungere o rimuovere lingue dall'installazione.

È inoltre possibile utilizzare il file Config.xml per operazioni di manutenzione quali l'aggiunta o la rimozione di caratteristiche, i ripristini e le disinstallazioni. A tale scopo, gli amministratori devono eseguire di nuovo Setup.exe dall'origine.

Importante:
Per modificare il file Config.xml, utilizzare un editor di testo, ad esempio il Blocco note. Non utilizzare un editor XML generico come Word 2013.

Contenuto dell'articolo:

• Guida di riferimento rapido degli elementi di Config.xml

• Utilizzo di Config.xml da parte del programma di installazione

• Formato del file Config.xml

• Guida di riferimento degli elementi di Config.xml

• File Config.xml di esempio

Guida di riferimento rapido degli elementi di Config.xml

Nella tabella seguente vengono elencati gli elementi di Config.xml. Tali elementi possono essere visualizzati in qualsiasi ordine, eccetto Elemento Configuration, che deve essere il primo, ed elementi come Elemento Command, il cui ordine in Config.xml incide sul modo in cui vengono elaborati durante l'installazione.

Guida di riferimento di Config.xml

Elemento	Descrizione
Elemento Configuration	Elemento di primo livello
Elemento AddLanguage	Aggiunge una lingua all'installazione
Elemento ARP	Valori che controllano il testo e il comportamento dell'opzione Programmi e funzionalità del Pannello di controllo, per aggiungere o rimuovere caratteristiche del prodotto
Elemento Command	Esegue un comando durante l'installazione
Elemento COMPANYNAME	Nome dell'organizzazione o dell'azienda dell'utente a cui appartiene il computer in cui si sta installando il prodotto
Elemento Display	Livello dell'interfaccia utente che il programma di installazione mostra all'utente
Elemento DistributionPoint	Percorso completo del punto di installazione di rete da cui deve essere eseguita l'installazione
Elemento INSTALLLOCATION	Percorso completo della cartella nel computer dell'utente in cui viene installato il prodotto
Elemento LIS	Opzioni che determinano il modo in cui l'origine di installazione locale viene memorizzata nella cache del computer dell'utente
Elemento Logging	Opzioni che determinano il tipo di registrazione eseguita dal programma di installazione
Elemento OptionState	Opzioni che consentono di specificare come gestire le singole caratteristiche del prodotto durante l'installazione
Elemento PIDKEY	Codice Product Key per contratti multilicenza di 25 caratteri
Elemento RemoveLanguage	Rimuove una lingua dall'installazione
Elemento Setting	Valori per le proprietà di Windows Installer
Elemento SetupUpdates	Percorso di ricerca utilizzato dal programma di installazione per l'individuazione dei file di personalizzazione dell'installazione
Elemento USERINITIALS	Iniziali dell'utente a cui appartiene il computer in cui si sta installando il prodotto
Elemento USERNAME	Nome dell'utente a cui appartiene il computer in cui si sta installando il prodotto

Utilizzo di Config.xml da parte del programma di installazione

Il programma di installazione cerca una copia di Config.xml nella stessa cartella che contiene Setup.exe. Se non la trova, utilizza il file Config.xml contenuto nella cartella principale del prodotto che si sta installando. Se il punto di installazione di rete contiene più prodotti, il programma di installazione attende che venga specificato quale prodotto installare prima di cercare la copia di Config.xml. La copia di Config.xml contenuta nella cartella del prodotto identifica il prodotto attraverso l'attributo Product di Elemento Configuration.

È inoltre possibile specificare il percorso del file Config.xml utilizzando l'opzione della riga di comando /config del programma di installazione. Ad esempio:

\\ server \ share \setup.exe /config \\ server \ share \ProPlus.WW\config.xml

Formato del file Config.xml

Gli elementi XML contenuti in Config.xml iniziano con < e terminano con />.

Il formato di base degli elementi è il seguente:

< element [attribute**="value"] [attribute="value"**] … />

Ad esempio:

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />

Note sul formato:

• Per elementi e attributi viene fatta distinzione tra maiuscole e minuscole.

• I valori degli attributi devono essere racchiusi tra virgolette doppie (") e per essi non viene fatta distinzione tra maiuscole e minuscole.

• La definizione di un elemento può estendersi su più righe. Nelle definizioni di elementi gli spazi, i ritorni a capo, gli avanzamenti di riga e le tabulazioni vengono ignorati.

  Di seguito viene illustrato un esempio di definizione di elemento estesa su più righe.

  <Display
     Level="none"
     CompletionNotice="no"
     SuppressModal="yes"
     AcceptEula="yes"
  />
  

Suggerimento:
Per le definizioni di elementi lunghe, disporre gli attributi su righe distinte e utilizzare i rientri per rendere il file più leggibile.

Elemento Configuration rappresenta un caso particolare ed è obbligatorio. Tutti gli altri elementi sono contenuti in Elemento Configuration e l'elemento è racchiuso tra tag </Configuration>, come illustrato nell'esempio seguente.

<Configuration Product="ProPlus">
  <!--  <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" />  --> 
  <!--  <Logging Type="standard" Path="%temp%" Template="Microsoft Office Professional Plus Setup(*).txt" />  --> 
  <!--  <USERNAME Value="Customer" />   --> 
  <!--  <COMPANYNAME Value="MyCompany" />   --> 
  <!--  <INSTALLLOCATION Value="%programfiles%\Microsoft Office" />   --> 
  <!--  <LIS CACHEACTION="CacheOnly" />   --> 
  <!--  <LIS SOURCELIST="\\server1\share\Office;\\server2\share\Office" /> -->
  <!--  <DistributionPoint Location="\\server\share\Office" />   --> 
  <!--  <OptionState Id="OptionID" State="absent" Children="force" />   --> 
  <!--  <Setting Id="SETUP_REBOOT" Value="IfNeeded" />   --> 
  <!--  <Command Path="%windir%\system32\msiexec.exe" Args="/i \\server\share\my.msi" QuietArg="/q" ChainPosition="after" Execute="install" />   --> 
  </Configuration>

È possibile aggiungere commenti delimitati da "<!--" e "-->" in qualsiasi posizione.

Ad esempio:

<!-- Configure install options for Microsoft Office Professional Plus 2010 -->
<Configuration Product="ProPlus" >
   <Display
      <!-- Turn off all Setup UI and prevent prompting users-->
      Level="none"
      CompletionNotice="no"
      SuppressModal="yes"
      <!-- Accept the EULA for the user -->
      AcceptEula="Yes"
   />
</Configuration>

Ogni cartella di prodotto di Office contiene un file Config.xml predefinito, costituito da un elemento Elemento Configuration con l'attributo Product impostato sul valore appropriato per il prodotto. Elemento Configuration include diversi esempi di elementi inseriti come commenti. Per attivare tali elementi, rimuovere i contrassegni di inizio e fine commento e immettere i valori di attributo appropriati.

Come illustrato nell'esempio seguente, è possibile attivare l'Elemento Display modificando questa riga:

<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->

in questa:

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="yes" />

L'opzione Display dell'esempio precedente indica al programma di installazione di eseguire un'installazione invisibile all'utente, affinché all'utente non venga richiesto di immettere informazioni e l'installazione non si fermi in attesa dell'interazione dell'utente.

Guida di riferimento degli elementi di Config.xml

Nelle descrizioni presenti in questa Guida di riferimento vengono adottate le convenzioni seguenti.

Convenzioni di formattazione

bold	Nome di elemento o di attributo
normale	Testo da immettere esattamente come illustrato
italic	Segnaposto di un valore da aggiungere
x|y	Scelta tra più valori
[x]	Valore facoltativo

Elemento Configuration

Elemento di primo livello. Questo elemento è obbligatorio e tutti gli altri elementi devono essere inseriti al suo interno.

Sintassi

<Configuration [Product="productID"] >

...

</Configuration>

Attributi

Nella tabella seguente vengono descritti i valori e gli attributi dell'elemento Configuration.

Attributi dell'elemento Configuration

Attributo	Valore	Descrizione
Product	productID	Valore dell'attributo ID dell'elemento Setup del file Setup.xml per il prodotto che si sta installando.

Osservazioni

L'attributo Product identifica il prodotto corrispondente a questo file Config.xml. L'productID è definito nel file Setup.xml contenuto nella cartella principale del prodotto, nell'attributo ID dell'elemento Setup.

L'attributo Product è facoltativo, a meno che non si imposti l'attributo Elemento Display Level su "basic" o "none". In questo caso l'attributo Product è obbligatorio. Se il prodotto specificato dall'attributo Product non esiste nel punto di installazione di rete, l'installazione verrà terminata.

Esempio

L'productID per Office Professional Plus 2013 è indicato in ProPlus.WW\Setup.xml alla riga seguente:

<Setup Id="ProPlus" Type="Product"  ... >

Tale productID in Config.xml viene utilizzato per specificare Office Professional Plus 2013 immettendo la riga seguente:

<Configuration Product="ProPlus">
   ...
</Configuration>

Elemento AddLanguage

Aggiunge la lingua specificata all'installazione.

Sintassi

<AddLanguage

   Id="ll-cc" | "match"

[ShellTransform="Yes"]

/>

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento AddLanguage.

Attributi di AddLanguage

Attributo	Valore	Descrizione
Id	ll - cc	Identificatore della lingua.
	match	Assume il valore dell'Id lingua delle impostazioni locali dell'utente di Windows.
ShellTransform	Yes	Specifica la lingua dell'interfaccia utente della shell. Se viene specificato più di un elemento AddLanguage, una (e una sola) lingua deve specificare l'elemento ShellTransform.

Osservazioni

È necessario che la lingua sia disponibile nel punto di installazione di rete.

È possibile utilizzare più elementi AddLanguage e Elemento RemoveLanguage. Se entrambi gli elementi Elemento RemoveLanguage e AddLanguage specificano la stessa lingua, l'elemento AddLanguage prevale e la lingua viene installata.

Quando si installa Office 2013, è necessario conoscere tre concetti sulle lingue:

• L'interfaccia utente del programma di installazione: la lingua dell'installazione.

• L'interfaccia utente della shell: la lingua dei collegamenti, dei menu di scelta rapida visualizzati facendo clic con il pulsante destro del mouse e delle descrizioni comandi.

• L'interfaccia utente di Office: la lingua dell'interfaccia utente e dei menu di Office.

In presenza di più lingue di Office questi tre valori sono determinati come segue:

Per impostazione predefinita, l'interfaccia utente del programma di installazione dipende dall'insieme delle risorse disponibili per l'installazione e dalla possibilità di assumere il valore delle impostazioni locali dell'utente. Per impostazione predefinita, l'interfaccia utente del programma di installazione assume il valore delle impostazioni locali dell'utente. L'interfaccia utente della shell dipende dal set di lingue in corso di installazione e, per impostazione predefinita, segue l'interfaccia utente del programma di installazione. La lingua predefinita dell'interfaccia utente di Office dipende dalle impostazioni locali e dalle impostazioni correnti dell'utente. Per impostazione predefinita vengono utilizzate le impostazioni locali dell'utente di Windows impostate nel computer di ogni utente. Questo significa che, nel caso predefinito, l'interfaccia utente del programma di installazione, l'interfaccia utente della shell e l'interfaccia utente di Office corrisponderanno.

Le impostazioni locali del sistema operativo Windows equivalgono a un set di informazioni sulle preferenze dell'utente relative all'ambito linguistico, ambientale e culturale. Tali informazioni sono rappresentate sotto forma di elenco di valori utilizzati per determinare la lingua di input corretta, il layout della tastiera, il criterio di ordinamento e i formati adottati per numeri, date, valute e orario. Le impostazioni locali dell'utente costituiscono una configurazione a livello dell'utente che determina i formati predefiniti utilizzati per la visualizzazione di date, orari, valute e numeri, nonché il criterio di ordinamento del testo. Per ogni account creato in un computer vengono specificate le relative impostazioni locali.

Se un amministratore specifica più lingue per l'installazione nel file Config.xml, la lingua dell'interfaccia utente della shell deve essere selezionata dal set di lingue in corso di installazione. A tale scopo, gli amministratori specificano l'attributo ShellTransform dell'elemento AddLanguage nel file Config.xml. AddLanguage specifica la lingua utilizzata dal programma di installazione per l'interfaccia utente della shell. Tuttavia, questo non incide necessariamente sulla scelta dell'interfaccia utente del programma di installazione o di Office al momento dell'installazione nel computer dell'utente.

Se ad esempio si dispone di un'immagine di Office con le lingue inglese, francese, tedesco e spagnolo, per fare in modo che il programma di installazione installi il supporto completo per tutte queste lingue e che l'interfaccia utente della shell adotti le opzioni internazionali predefinite dell'utente è necessario aggiungere al file Config.xml gli elementi seguenti:

<AddLanguage Id="match" ShellTransform="yes"/> <AddLanguage Id="en-us" /> <AddLanguage Id="fr-fr" /> <AddLanguage Id="de-de" /> <AddLanguage Id="es-es" />

Nell'esempio precedente il programma di installazione installa tutte le lingue specificate e l'interfaccia utente della shell assume la lingua delle impostazioni locali dell'utente. Se nell'immagine di origine fossero disponibili più lingue, l'utilizzo del valore match nell'esempio precedente potrebbe comportare l'installazione di una lingua aggiuntiva, nel caso in cui la lingua di match non corrispondesse a una delle quattro esplicitamente indicate. Se ad esempio l'origine avesse incluso anche il giapponese, durante l'installazione in un computer le cui impostazioni locali prevedono il giapponese, oltre alle quattro lingue specificate sarebbe stato installato anche il giapponese.

Esempio

<AddLanguage Id="en-us" ShellTransform="Yes" />

Elemento ARP

Specifica valori che controllano il testo e il comportamento di Programmi e funzionalità nel Pannello di controllo per il prodotto.

Sintassi

<ARP attribute =" value " [attribute**="value"**] ... />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento ARP.

Attributi di ARP

Attributo	Valore	Descrizione
ARPCOMMENTS	text	Testo aggiuntivo. Può contenere fino a 255 caratteri, sebbene potrebbero non essere visualizzati tutti i caratteri.
ARPCONTACT	text	Elenco di contatti del supporto tecnico.
ARPNOMODIFY	Yes	Impedisce agli utenti di modificare l'installazione del prodotto rendendo il pulsante Cambia non disponibile.
	No (predefinito)	Consente agli utenti di modificare l'installazione del prodotto.
ARPNOREMOVE	Yes	Impedisce agli utenti di rimuovere il prodotto rendendo il pulsante Rimuovi non disponibile.
	No (predefinito)	Consente agli utenti di rimuovere il prodotto.
ARPURLINFOABOUT	URL	URL della home page del prodotto.
ARPURLUPDATEINFO	URL	URL per informazioni sugli aggiornamenti del prodotto.
ARPHELPLINK	URL	URL di un sito Web in cui gli utenti possono ricevere supporto tecnico.
ARPHELPTELEPHONE	text	Numeri di telefono per il supporto tecnico.

Elemento Command

Specifica una riga di comando da eseguire. Per ulteriori informazioni, vedere la sezione Osservazioni più avanti in questo articolo.

Suggerimento:
L'opzione equivalente nello Strumento di personalizzazione di Office è Add installations and run programs.

Sintassi

<Command

   Path="path"

[QuietArg="arguments"]

[Args="args"]

[ChainPosition="Before" | "After" (predefinito)]

[Wait="mseconds"]

[Execute="Install"(predefinito) | "Uninstall"]

[Platform="x86"(predefinito) | "x64"]

/>

Attributi

Nella tabella seguente vengono descritti gli attributi dell'elemento Command.

Attributi di Command

Attributo	Valore	Descrizione
Path	path	Percorso completo del file eseguibile. Se il valore del percorso contiene uno spazio, è necessario utilizzare le virgolette come illustrato nell'esempio seguente: "\\server\share\Office 14\copylogs.bat"
QuietArg	string	Stringa di argomenti da aggiungere alla riga di comando se si configura un'installazione invisibile all'utente. Per ulteriori informazioni sulle circostanze in cui utilizzare l'attributo QuietArg, vedere la sezione Osservazioni al termine di questa tabella.
Args	string	Stringa di argomenti da passare all'eseguibile. Per informazioni sulle circostanze in cui utilizzare l'attributo Args per le installazioni concatenate, vedere la sezione Osservazioni al termine di questa tabella. Se il valore dell'elemento Args include virgolette, è possibile racchiudere l'intero valore tra virgolette singole ('), come illustrato nell'esempio seguente: Args='"/param value"'
ChainPosition	Before	Questo comando viene eseguito prima dell'installazione del prodotto principale.
	After (predefinito)	Questo comando viene eseguito dopo l'installazione del prodotto principale.
Wait	mseconds	Durante l'installazione di un prodotto, l'attributo Level di Elemento Display impostato su "full" o "basic" indica il numero di millisecondi da attendere dopo l'esecuzione del programma prima di procedere con l'installazione. Il valore predefinito è 0 (zero) e indica che non è prevista alcuna attesa.
Execute	Install (predefinito)	Il programma di installazione esegue questo comando dopo il completamento dell'installazione del prodotto principale.
	Uninstall	Il programma di installazione esegue questo comando dopo il completamento della disinstallazione del prodotto principale.
Platform	x86 (predefinito)	Specifica che il programma richiede la piattaforma Intel x86. Questo comando viene eseguito solo se il computer in cui viene eseguita l'installazione soddisfa i requisiti della piattaforma.
	x64	Specifica che il programma richiede un processore a 64 bit che supporti le estensioni x64 dell'architettura x86. Questo comando viene eseguito solo se il computer in cui viene eseguita l'installazione soddisfa i requisiti della piattaforma.

Osservazioni

L'elemento Command del file Config.xml e l'opzione Aggiungi installazioni ed esegui programmi dello Strumento di personalizzazione di Office (righe di comando immesse nelle finestre di dialogo Aggiungi voce programma e Modifica voce programma) sono destinati al solo utilizzo durante l'installazione iniziale e la disinstallazione di un prodotto. I comandi dell'elemento Command vengono elaborati solo durante l'installazione iniziale e la disinstallazione. I comandi dell'elemento Command eventualmente utilizzati per configurazioni successive all'installazione iniziale vengono ignorati.

È possibile impostare la riga di comando per l'esecuzione di un comando arbitrario o di un eseguibile di piccole dimensioni da avviare dopo l'installazione del prodotto.

L'elemento Command del file Config.xml e l'opzione Aggiungi installazioni ed esegui programmi dello Strumento di personalizzazione di Office non offrono le funzionalità di distribuzione software tipiche di uno strumento di distribuzione e gestione di software aziendale e per questo non consentono, ad esempio, di tenere traccia dell'avanzamento della distribuzione o di risolvere i problemi. È pertanto consigliabile utilizzare l'elemento Command di Config.xml e Aggiungi installazioni ed esegui programmi dello Strumento di personalizzazione di Office solo per eseguire file eseguibili di piccole dimensioni o comandi arbitrari che non apportano modifiche nel computer e non richiedono l'input dell'utente. È possibile ad esempio eseguire un'utilità per la copia dei log o un comando per l'avvio di una pagina di benvenuto al termine dell'installazione.

Importante:

Il concatenamento non è affidabile quanto l'installazione separata di ogni prodotto. Se ad esempio si concatenano due installazioni e l'installazione di uno dei prodotti ha esito negativo o genera un errore imprevisto, l'installazione principale e l'installazione concatenata potrebbero non essere completate. È pertanto preferibile non ricorrere al concatenamento. Il metodo consigliato per l'installazione simultanea di più prodotti in ambienti aziendali consiste nell'utilizzo di un programma di gestione della distribuzione, ad esempio Microsoft System Center 2012 Configuration Manager, Microsoft Systems Management Server (SMS) 2003 o uno strumento di terze parti, in alternativa al concatenamento.

Di seguito è indicato l'utilizzo di Args e QuietArg:

• L'attributo Args viene sempre aggiunto al comando. Può includere parametri come "/install" o **"Company=**MyCorporation".

• Se si esegue un'installazione invisibile all'utente (con Display impostato come Display="none"), viene aggiunto anche l'attributo QuietArg. In questi casi è possibile specificare l'attributo QuietArg con il parametro "/quiet" specificando, ad esempio QuietArg="/quiet".

Note sull'attributo Wait:

• Se si imposta l'attributo Wait su 0 millisecondi, non vi sarà attesa tra l'esecuzione del programma e il proseguimento dell'installazione. Il comando verrà eseguito e si procederà immediatamente.

  I codici restituiti vengono rispettati solo se il valore di Wait è diverso da zero. Se si specifica 0, il programma di installazione non interromperà l'installazione dopo l'esecuzione del programma specificato. In tal caso non vi sarà alcun codice restituito.

• Se si imposta l'attributo Wait su un valore positivo qualsiasi diverso da zero, l'attesa corrisponderà esattamente al numero di millisecondi indicato. Se il processo termina prima del tempo indicato, l'installazione proseguirà. Se allo scadere del tempo indicato il processo non è ancora terminato, l'installazione avrà esito negativo.

• Se si imposta l'attributo Wait su -1, l'attesa sarà illimitata. Questo può rappresentare un problema perché se il processo del comando smette di rispondere (si blocca), l'installazione smetterà di rispondere a sua volta e attenderà all'infinito l'esecuzione del comando.

Nel caso in cui vi siano due o più elementi Command nel file Config.xml, verranno eseguiti nell'ordine in cui sono indicati in Config.xml.

Esempi

<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="30000" />

Elemento COMPANYNAME

Nome dell'organizzazione o dell'azienda dell'utente a cui appartiene il computer in cui si sta installando il prodotto.

Suggerimento:
L'opzione equivalente nello Strumento di personalizzazione di Office è l'impostazione Nome organizzazione in Installation location and organization name.

Sintassi

<COMPANYNAME Value=" companyname " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento COMPANYNAME.

Attributi di COMPANYNAME

Attributo	Valore	Descrizione
Value	companyname	Nome dell'azienda o dell'organizzazione.

Esempio

<COMPANYNAME Value="Microsoft Corporation" />

Elemento Display

Livello dell'interfaccia utente che il programma di installazione mostra all'utente.

Suggerimento:
L'opzione equivalente nello Strumento di personalizzazione di Office è l'impostazione di Livello visualizzazione e del contratto di licenza in "Licensing and user interface" in Informazioni di riferimento sullo Strumento di personalizzazione di Office per Office 2013.

Sintassi

<Display

Level="None" | "Basic" | "Full"(predefinito)

CompletionNotice="Yes" | "No"(predefinito)

SuppressModal="Yes" | "No"(predefinito)

NoCancel="Yes" | "No"(predefinito)

AcceptEula="Yes" | "No"(predefinito)

/>

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento Display.

Attributi di Display

Attributo	Valore	Descrizione
Level	None	L'interfaccia utente del programma di installazione non viene visualizzata. Se si imposta Display Level="none", verrà eseguita un'installazione invisibile all'utente (automatica). Per ulteriori informazioni, vedere la sezione Osservazioni.
	Basic	Il programma di installazione visualizza una schermata di benvenuto, la pagina del codice Product Key (PIDKEY), se necessario, la pagina delle condizioni di licenza software, se necessario, un indicatore di stato e la notifica di completamento, se consentita.
	Full (predefinito)	Il programma di installazione visualizza l'interfaccia utente completa.
CompletionNotice	Yes	È applicabile solo se Level è impostato su "basic" o "none": il programma di installazione visualizza la notifica di completamento.
	No (predefinito)	È applicabile solo se Level è impostato su "basic": il programma di installazione non visualizza la notifica di completamento.
SuppressModal	Yes	È applicabile solo se Level è impostato su "basic": il programma di installazione non visualizza messaggi di errore e altre finestre di dialogo che possano interrompere l'installazione.
	No (predefinito)	È applicabile solo se Level è impostato su "basic": il programma di installazione visualizza messaggi di errore e altre finestre di dialogo in base alle necessità.
NoCancel	Yes	Se Level è impostato su "full" o "basic", viene disabilitato il pulsante di annullamento (la X nell'angolo superiore destro della finestra di dialogo di stato).
	No (predefinito)	Se Level è impostato su "full" o "basic", consente all'utente di annullare l'installazione dall'indicatore di stato.
AcceptEULA	Yes	Le condizioni di licenza software Microsoft vengono accettate per conto dell'utente. Il programma di installazione non visualizza la pagina delle condizioni di licenza software.
	No (predefinito)	Se Level non è impostato su "none", il programma di installazione visualizza la pagina delle condizioni di licenza software.

Osservazioni

Se questo elemento non è definito, vengono utilizzate le impostazioni predefinite. Se viene specificato un valore non valido, l'installazione verrà terminata.

Se l'attributo Level è impostato su "basic" o "none" e si immette un codice Product Key tramite Elemento PIDKEY, le condizioni di licenza si considerano accettate per conto dell'utente.

Esempio

<Display Level="none" CompletionNotice="no" SuppressModal="yes" AcceptEula="Yes" />

Elemento DistributionPoint

Specifica il percorso completo del punto di installazione di rete da cui deve essere eseguita l'installazione

Sintassi

<DistributionPoint Location=" path " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento DistributionPoint.

Attributi di DistributionPoint

Attributo	Valore	Descrizione
Location	path	Percorso completo del punto di installazione di rete da cui deve essere eseguita l'installazione

Osservazioni

Se non è specificato, il programma di installazione presuppone che il file Setup.exe sia ubicato nella radice del punto di installazione di rete.

Esempio

<DistributionPoint Location="\\server1\office" />

Elemento INSTALLLOCATION

Specifica il percorso completo della cartella nel computer dell'utente in cui viene eseguita l'installazione.

Suggerimento:
L'opzione equivalente nello Strumento di personalizzazione di Office è l'impostazione Percorso di installazione predefinito in Installation location and organization name.

Sintassi

<INSTALLLOCATION Value=" path " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento INSTALLLOCATION.

Attributi di INSTALLLOCATION

Attributo	Valore	Descrizione
Value	path	Percorso completo della cartella nel computer dell'utente in cui viene installato il prodotto.

Osservazioni

È possibile includere variabili di ambiente di sistema nel percorso. Se questo elemento non è specificato, Office viene installato in %ProgramFiles%\Microsoft Office.

Esempio

<INSTALLLOCATION Value="%ProgramFiles%\MyApps" />

Elemento LIS

Controlla il modo in cui l'origine di installazione locale viene memorizzata nella cache del computer dell'utente e specifica il percorso di uno o più punti di installazione di rete contenenti i file di installazione del prodotto.

Sintassi

<LIS

[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]

[SOURCELIST=" semicolon-delimited-path-list "]

/>

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento LIS.

Attributi di LIS

Attributo	Valore	Descrizione
CACHEACTION	CacheOnly	Il programma di installazione copia l'origine di installazione locale nel computer dell'utente, ma non installa il prodotto. Nota Non utilizzare elementi Command in un file Config.xml che specifica il valore CacheOnly, perché i comandi specificati non verrebbero eseguiti.
	RemoveCacheOnly	Se la cache viene copiata nel computer dell'utente e Office non è installato, il programma di installazione rimuove l'origine di installazione locale dal computer dell'utente, ma non installa o disinstalla il prodotto.
SOURCELIST	semicolon-delimited-path-list	Elenco, separato da punto e virgola, di uno o più punti di installazione di rete contenenti i file di installazione del prodotto. L'opzione equivalente nello Strumento di personalizzazione di Office è Additional network sources.

Osservazioni

Per impostazione predefinita, l'origine di installazione locale viene creata nella cartella \MsoCache\All Users alla radice dell'unità in cui viene installato Office. Vengono copiati anche i file di configurazione dell'installazione e gli aggiornamenti software presenti nella cartella Updates del punto di installazione di rete.

Se si specifica Elemento INSTALLLOCATION, la designazione dell'unità nel percorso è utilizzata per determinare in quale unità creare l'origine di installazione locale. Se ad esempio il percorso di Elemento INSTALLLOCATION è E:\office\files, l'origine di installazione locale viene creata nell'unità E. Le origini elencate dall'attributo SOURCELIST vengono conservate con il prodotto installato e utilizzate dal programma di installazione quando l'origine di installazione locale non è presente nel computer dell'utente o è danneggiata.

Esempio

<LIS CACHEACTION="CacheOnly" />   
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />

Elemento Logging

Specifica il tipo di registrazione eseguita dal programma di installazione.

Sintassi

<Logging

   Type="Off" | "Standard"(predefinito) | "Verbose"

   Path="path"

Template=" filename .txt"

/>

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento Logging.

Attributi di Logging

Attributo	Valore	Descrizione
Type	Off	Il programma di installazione non esegue alcuna registrazione.
	Standard (predefinito)	Il programma di installazione scrive le informazioni di installazione nel file di log.
	Verbose	Il programma di installazione scrive tutte le informazioni di installazione nel file di log.
Path	path	Percorso completo della cartella utilizzata per il file di log. È possibile utilizzare variabili di ambiente. Il valore predefinito è %temp%.
Template	filename .txt	Nome del file di log. Se si immette la stringa * in un punto qualsiasi del nome file, viene creato un file di log univoco per ogni installazione eseguita da setup.exe, come spiegato più avanti in questo articolo. Se il carattere * non viene incluso e il nome file specificato esiste già, le informazioni di log vengono aggiunte al file esistente. L'estensione txt del nome file è obbligatoria. Il modello predefinito è SetupExe(*).log.

Osservazioni

È possibile specificare il carattere * in qualsiasi punto del valore Template. In quella posizione il programma di installazione inserisce una stringa con il formato seguente:

YYYYMMDDHHMMSS xxx

dove:

1. YYYY = Anno

2. MM = Mese

3. DD = Giorno

4. HH = Ore

5. MM = Minuti

6. SS = Secondi

7. xxx = stringa univoca generata dal programma di installazione

Esempio

<Logging Type="standard" Path="%temp%" 
   Template="MyLog(*).txt" 
/>

Nell'esempio seguente il programma di installazione crea un file di log ogni volta che installa il prodotto. Il programma di installazione utilizza nomi di file univoci simili a quello indicato di seguito:

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

Elemento OptionState

Specifica come vengono gestite caratteristiche specifiche del prodotto durante l'installazione.

Importante:
Nella maggior parte dei casi, è consigliabile modificare lo stato di installazione delle caratteristiche utilizzando lo Strumento di personalizzazione di Office. L'opzione equivalente nello Strumento di personalizzazione di Office è Set feature installation states.

Sintassi

<OptionState

Id=" IDopzione "

State="Absent" | "Advertise" | "Local"

[Children="force"]

/>

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento OptionState.

Attributi di OptionState

Attributo	Valore	Descrizione
Id	optionID	Elemento che l'utente può scegliere di installare.
State	Absent	La caratteristica non viene installata.
	Advertise	La caratteristica viene installata al primo utilizzo.
	Local	La caratteristica viene installata sul computer dell'utente.
Children	force	Tutte le caratteristiche figlio della caratteristica vengono impostate sullo stato specificato.

Osservazioni

Una caratteristica è un elemento che l'utente può scegliere di installare. Il valore Id di una caratteristica è definito nell'elemento Option del file Setup.xml nella cartella principale del prodotto.

Esempio

<OptionState Id="ExcelAddinFiles" 
   State="Absent" 
   Children="force" 
/>

Elemento PIDKEY

Codice Product Key per contratti multilicenza di 25 caratteri.

Importante:
Queste informazioni sono applicabili solo alle edizioni con contratto multilicenza di Office 2013. Non si applicano a Office 365 ProPlus, concesso in licenza tramite sottoscrizione.

Sintassi

<PIDKEY Value=" 25-character-key " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento PIDKEY.

Attributi di PIDKEY

Attributo	Valore	Descrizione
Value	25-character-key	Codice Product Key per contratti multilicenza di 25 caratteri.

Osservazioni

Quando il valore di PIDKEY è impostato, agli utenti non viene richiesto di immettere un codice Product Key durante l'installazione di Office.

Per immettere un codice Product Key per attivazione multipla nel file Config.xml, aggiungere al file la riga seguente:

<PIDKEY Value="AAAAABBBBBCCCCCDDDDDEEEEE" />

Dove AAAAABBBBBCCCCCDDDDDEEEEE è il codice Product Key di 25 caratteri. Per altre informazioni sulle licenze di Office 2013, vedere Attivazione dei contratti multilicenza di Office 2013.

Esempio

<PIDKEY Value="1234512345123451234512345" />

Elemento RemoveLanguage

Rimuove la lingua specificata dall'installazione.

Sintassi

<RemoveLanguage Id=" ll - cc " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento RemoveLanguage.

Attributi di RemoveLanguage

Attributo	Valore	Descrizione
Id	ll-cc	Identificatore della lingua.

Osservazioni

Se la lingua non è installata nel computer dell'utente, l'elemento RemoveLanguage viene ignorato.

È possibile utilizzare più elementi Elemento AddLanguage e RemoveLanguage. Se gli elementi RemoveLanguage e Elemento AddLanguage specificano la stessa lingua, l'elemento Elemento AddLanguage prevale e la lingua viene installata.

Esempio

<RemoveLanguage Id="en-us" />

Elemento Setting

Consente di specificare valori per le proprietà di Windows Installer.

Suggerimento:
L'opzione equivalente nello Strumento di personalizzazione di Office è "Modifica proprietà installazione" in Informazioni di riferimento sullo Strumento di personalizzazione di Office per Office 2013.

Sintassi

<Setting Id=" name " Value=" value " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento Setting.

Attributi di Setting

Attributo	Valore	Descrizione
Id	name	Nome della proprietà di Windows Installer.
Value	value	Valore da assegnare alla proprietà.

Osservazioni

Non tutte le proprietà di Windows Installer possono essere specificate nell'elemento Setting. Se viene specificata una proprietà bloccata, il processo di installazione verrà terminato. Se viene specificata una proprietà supportata, il programma di installazione la passa direttamente a Windows Installer.

L'elemento Setting supporta le seguenti proprietà del servizio di gestione delle chiavi:

• KMSSERVICENAME - Specifica il nome dell'host del servizio di gestione delle chiavi.

• KMSSERVICEPORT - Specifica la porta dell'host del servizio di gestione delle chiavi.

Per utilizzare le proprietà del servizio di gestione delle chiavi, ad esempio, fare riferimento alla sintassi seguente:

<Setting Id="KMSSERVICENAME" Value="contoso.com" />

<Setting Id="KMSSERVICEPORT" Value="1234" />

dove:

contoso.com è il nome dell'host del servizio di gestione delle chiavi

1234 è il valore del numero di porta

L'elemento Setting supporta la proprietà AUTO_ACTIVATE per l'attivazione tramite codice Product Key. Questa proprietà specifica che l'attivazione del prodotto avviene automaticamente durante la distribuzione di Office 2013 e utilizza la sintassi seguente:

<Setting Id="AUTO_ACTIVATE" Value="1" />

L'elemento Setting supporta la proprietà REMOVEPREVIOUS. Tale proprietà rimuove l'applicazione specificata dall'installazione e utilizza la sintassi seguente:

<Setting Id="REMOVEPREVIOUS" Value="Option Id" />

dove Option Id è il valore identificativo dell'applicazione Office 2013. Per specificare più applicazioni, utilizzare un elenco di valori Option Id separati da virgola.

Se si specifica REMOVEPREVIOUS con un valore Option Id, vengono rimosse solo le applicazioni specificate.

Se non si specifica REMOVEPREVIOUS, le applicazioni di Office installate precedentemente per le quali è in corso l'installazione di una versione sostitutiva vengono rimosse. Questo è il comportamento predefinito.

Se si specifica REMOVEPREVIOUS con un valore vuoto (REMOVEPREVIOUS=""), non viene rimossa alcuna applicazione.

L'elemento Setting supporta anche la proprietà SETUP_REBOOT. SETUP_REBOOT provoca un riavvio dopo l'installazione e utilizza la sintassi seguente. Per la proprietà SETUP_REBOOT è necessario utilizzare tutte lettere maiuscole.

<Setting Id="SETUP_REBOOT" Value="value" />

dove value può assumere uno dei valori seguenti:

• AutoAlways - Riavvia sempre, senza chiedere conferma all'utente.

• Always - Chiede sempre di riavviare al termine dell'installazione.

• IfNeeded - Chiede di riavviare al termine dell'installazione se l'installazione richiede un riavvio (predefinito).

• AutoIfNeeded - Riavvia se l'installazione richiede un riavvio. Non chiede conferma all'utente.

• Never - Non riavvia né chiede mai di riavviare.

Esempi

<Setting Id="SETUP_REBOOT" Value="Never" />
<Setting Id="REMOVEPREVIOUS" Value="WORDFiles" />

Elemento SetupUpdates

Specifica un percorso di ricerca utilizzato dal programma di installazione per l'individuazione dei file di personalizzazione dell'installazione.

Sintassi

<SetupUpdates

[CheckForSUpdates="Yes" (predefinito) | "No"]

[SUpdateLocation="path-list"]

/>

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento SetupUpdates.

Attributi di SetupUpdates

Attributo	Valore	Descrizione
CheckForSUpdates	Yes (predefinito)	Il programma di installazione utilizza l'elenco di percorsi in SUpdateLocation per trovare i file di personalizzazione dell'installazione.
	No	Il programma di installazione non cerca i file di personalizzazione dell'installazione nei percorsi elencati in SUpdateLocation.
SUpdateLocation	path-list	Elenco di percorsi di cartelle completi, separati da punto e virgola. Nota Non è possibile utilizzare variabili di ambiente nel percorso indicato in SUpdateLocation. Se il percorso contiene una variabile di ambiente, il programma di installazione ignorerà i file di aggiornamento disponibili in tale percorso.

Osservazioni

Il programma di installazione cerca in tutte le cartelle specificate i file di personalizzazione dell'installazione creati per il prodotto da installare e li applica in ordine alfabetico in base al nome. Se nella riga di comando del programma di installazione è stato specificato un file di personalizzazione dell'installazione, tale file verrà applicato per primo, seguito dai file eventualmente trovati nella cartella specificata da questo elemento.

Esempio

<SetupUpdates
   CheckForSUpdates="Yes"
   SUpdateLocation="\\server1\office\updates;\\server2\corpdata\updates"
/>

Elemento USERINITIALS

Iniziali dell'utente a cui appartiene il computer in cui si sta installando il prodotto.

Sintassi

<USERINITIALS Value=" value " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento USERINITIALS.

Attributi di USERINITIALS

Attributo	Valore	Descrizione
Value	value	Iniziali dell'utente

Esempio

<USERINITIALS Value="JD" />

Elemento USERNAME

Nome dell'utente a cui appartiene il computer in cui si sta installando il prodotto.

Sintassi

<USERNAME Value=" value " />

Attributi

Nella tabella seguente vengono descritti gli attributi e i valori dell'elemento USERNAME.

Attributi di USERNAME

Attributo	Valore	Descrizione
Value	value	Nome dell'utente

Osservazioni

I dati dell'elemento Username di Office 2013 vengono inseriti come indicato di seguito.

Se l'utente che esegue Office è lo stesso che ha installato Office, vengono utilizzati i valori di Username e Initials specificati durante l'installazione. All'utente non viene richiesto di immetterli al primo avvio di Office. Questo è il caso più comune tra gli utenti domestici che installano Office autonomamente.

Se l'utente che esegue Officenon è lo stesso che ha installato Office, al primo avvio di Office gli verrà chiesto di confermare i valori di Username e Initials. Questo è il caso più comune negli ambienti aziendali, in cui Office viene installato da un amministratore per conto di un utente.

Il valore dell'elemento Username mostrato all'utente al primo avvio potrebbe essere preimpostato con un valore predefinito determinato in base a una versione preesistente di Office o all'utente corrente. Si noti che il valore predefinito viene utilizzato solo se confermato dall'utente. Se nel computer è installata una versione precedente di Office, viene utilizzata la chiave del Registro di sistema creata per tale versione di Office. Se ad esempio l'installazione precedente di Office è Microsoft Office 2003, la chiave del Registro di sistema è contenuta in HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo.

Esempio

<USERNAME Value="John Doe" />

File Config.xml di esempio

Nell'esempio seguente è riportato un file Config.xml per un'installazione tipica. Nell'esempio viene utilizzata la versione Office Professional Plus 2013 del prodotto.

<Configuration Product="ProPlus">

<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->

<!-- <Logging Type="standard" Path="%temp%" Template="Microsoft Office Professional Plus Setup(*).txt" /> -->

<!-- <USERNAME Value="Customer" /> -->

<!-- <COMPANYNAME Value="MyCompany" /> -->

<!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->

<!-- <LIS CACHEACTION="CacheOnly" /> -->

<!-- <LIS SOURCELIST="\\server1\share\Office;\\server2\share\Office" /> -->

<!-- <DistributionPoint Location="\\server\share\Office" /> -->

<!-- <OptionState Id="OptionID" State="absent" Children="force" /> -->

<!-- <Setting Id="SETUP_REBOOT" Value="IfNeeded" /> -->

<!-- <Command Path="%windir%\system32\msiexec.exe" Args="/i \\server\share\my.msi" QuietArg="/q" ChainPosition="after" Execute="install" /> -->

</Configuration>

Vedere anche

Informazioni di riferimento sullo Strumento di personalizzazione di Office per Office 2013
Edizioni a 64 bit di Office 2013