File Config.xml in Office System 2007
Aggiornamento: settembre 2010
Si applica a: Office Resource Kit
Ultima modifica dell'argomento: 2015-03-09
Per i professionisti IT che utilizzano TechNet o l'Office Resource Kit, è consigliabile partecipare al sondaggio in linea(informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=132189\&clcid=0x410) per consentire di soddisfare al meglio ogni esigenza relativa alla documentazione. Per ulteriori informazioni sulle attività per il miglioramento della documentazione, visitare il Blog dell'Office Resource Kit(informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=125627\&clcid=0x410).
Contenuto dell'articolo:
Informazioni di riferimento rapido sugli elementi di Config.xml
Modalità di funzionamento
Formato del file Config.xml
Informazioni di riferimento sugli elementi di Config.xml
File Config.xml di esempio
Lo strumento principale per personalizzare l'installazione dei prodotti in Microsoft Office System 2007 è lo Strumento di personalizzazione di Office. Per ulteriori informazioni sull'utilizzo di questo strumento per creare un file di personalizzazione dell'installazione, vedere Strumento di personalizzazione di Office in Office System 2007.
Il file Config.xml consente di configurare attività di installazione e viene utilizzato solo durante l'esecuzione dell'installazione; non viene installato o memorizzato nella cache del computer dell'utente. L'amministratore può modificare il file Config.xml per personalizzare l'installazione. Per impostazione predefinita, il file Config.xml memorizzato nelle cartelle del prodotto principale (la cartella nome_cartella_prodotto_principale.WW, ad esempio, Enterprise.WW o Pro.WW) contiene le indicazioni necessarie al programma di installazione per installare il prodotto. Il file Config.xml contenuto nella cartella Pro.WW, ad esempio, installa Microsoft Office Professional 2007.
È possibile utilizzare il file Config.xml per eseguire le attività di installazione seguenti:
Impostazione del percorso del punto di installazione dalla rete.
Selezione del prodotto da installare.
Personalizzazione del programma di installazione, ad esempio la registrazione e la posizione del file di personalizzazione dell'installazione e degli aggiornamenti software.
Impostazione delle opzioni di installazione, ad esempio il nome dell'utente e della società.
Copia dell'origine di installazione locale nel computer dell'utente senza installare Office.
Aggiunta o rimozione di lingue dall'installazione.
È inoltre possibile utilizzare il file Config.xml per operazioni di manutenzione, ad esempio per l'aggiunta o la rimozione di caratteristiche, oltre che per i ripristini e le disinstallazioni. A tale scopo, l'amministratore deve eseguire nuovamente il file Setup.exe dall'origine dati originale. Per ulteriori informazioni, vedere la sezione sull'utilizzo del file Config.xml per la manutenzione in Procedure consigliate per la gestione di Office System 2007.
Il file Config.xml è necessario per personalizzare un'installazione da distribuire con l'installazione delle applicazioni basata su Criteri di gruppo. Per ulteriori informazioni, vedere Utilizzare Criteri di gruppo Installazione software per distribuire Office System 2007.
.gif "Important") Importante: |
|---|
| Per modificare Config.xml, utilizzare un editor di testo quale ad esempio il Blocco note. Non utilizzare un editor XML generico come Microsoft Office Word 2007. |
Per informazioni su come modificare il file Config.xml e per un esempio di un file Config.xml personalizzato, vedere Distribuire configurazioni personalizzate di Office System 2007 (procedura dettagliata).
Informazioni di riferimento rapido sugli elementi di Config.xml
Nella tabella che segue è riportato un elenco degli elementi inclusi in Config.xml. Tali elementi possono comparire in qualsiasi ordine, ad eccezione di Elemento Configuration, che deve essere il primo, e di elementi quali Elemento Command, il cui ordine in Config.xml influisce sull'ordine di elaborazione durante l'installazione.
| Elemento | Descrizione |
|---|---|
Elemento Configuration |
Elemento principale |
Elemento AddLanguage |
Aggiunge una lingua all'installazione |
Elemento ARP |
Valori che controllano il testo e il comportamento di Installazione applicazioni nel Pannello di controllo del prodotto |
Elemento CCP_DRIVE |
Percorso completo della cartella in cui RMCCPSEARCH esegue la ricerca |
Elemento Command |
Esegue un comando durante l'installazione |
Elemento COMPANYNAME |
Nome dell'organizzazione o della società dell'utente sul cui computer viene installato il prodotto |
Elemento Display |
Livello di interfaccia utente visualizzato all'utente dal programma di installazione |
Elemento DistributionPoint |
Percorso completo del punto di installazione di rete da cui deve essere eseguita l'installazione |
Elemento INSTALLLOCATION |
Percorso completo della cartella sul computer dell'utente in cui viene installato il prodotto |
Elemento LIS |
Opzioni per specificare in che modo l'origine di installazione locale viene memorizzata nella cache del computer dell'utente |
Elemento Logging |
Opzioni per il tipo di registrazione effettuata dal programma di installazione |
Elemento MinOSRequirement |
Sistema operativo minimo supportato per il prodotto |
Elemento OptionState |
Opzioni per specificare come gestire le singole caratteristiche del prodotto durante l'installazione |
Elemento PIDKEY |
Codice Volume License di 25 caratteri |
Elemento RemoveLanguage |
Rimuove una lingua dall'installazione |
Elemento Setting |
Valori delle proprietà di Windows Installer |
Elemento SetupUpdates |
Percorso di ricerca che il processo di installazione deve utilizzare per cercare i file di personalizzazione dell'installazione |
Elemento USERINITIALS |
Iniziali dell'utente sul cui computer viene installato il prodotto |
Elemento USERNAME |
Nome dell'utente sul cui computer viene installato il prodotto |
Modalità di funzionamento
Il programma di installazione cerca una copia di Config.xml nella stessa cartella di Setup.exe. Se non viene trovata una copia in tale percorso, viene utilizzato il file Config.xml disponibile nella cartella del prodotto principale che si sta installando (se nel punto di installazione di rete vi sono più prodotti, il programma di installazione chiederà di specificare il prodotto da installare prima di cercare una copia di Config.xml). La copia di Config.xml presente nella cartella del prodotto identifica il prodotto utilizzando l'attributo Product dell'elemento Elemento Configuration.
Per specificare il percorso del file Config.xml, è inoltre possibile utilizzare l'opzione della riga di comando /config di Setup. Ad esempio:
\\ server \ condivisione \setup.exe /config \\ server \ condivisione \Enterprise.WW\config.xml
[!NOTA] Se si è inoltre creato un file di personalizzazione dell'installazione utilizzando lo Strumento di personalizzazione di Office, le personalizzazioni definite in Config.xml avranno priorità su quelle nel file di personalizzazione.
Formato del file Config.xml
Gli elementi XML di Config.xml iniziano con < e terminano con />.
Il formato di base degli elementi è il seguente:
< elemento [attributo**="valore"] [attributo="valore"**] … />
Ad esempio:
<Display Level="none" AcceptEula="Yes" />
Per gli elementi e gli attributi viene rilevata la distinzione tra maiuscole e minuscole. I valori degli attributi devono essere delimitati da virgolette ("), ma per essi non viene rilevata la distinzione tra maiuscole e minuscole.
La definizione di un elemento può estendersi su più righe e all'interno di tale definizione vengono ignorati gli spazi, i ritorni a capo, gli avanzamenti riga e i caratteri di tabulazione.
Ad esempio:
<Display
Level="none"
AcceptEula="yes"
/>
.gif "Tip") Suggerimento: |
|---|
| Per le definizioni di elementi particolarmente lunghe, inserire gli attributi su righe diverse, utilizzando i rientri per rendere più agevole la lettura del file. |
L'elemento Elemento Configuration è particolare ed obbligatorio. Tutti gli altri elementi sono contenuti all'interno di Elemento Configuration e tale elemento è chiuso da </Configuration>.
Ad esempio:
<Configuration Product="Enterprise">
<PIDKEY Value="1234512345123451234512345" />
<Display Level="none" AcceptEula="Yes"/>
</Configuration>
I commenti possono essere aggiunti in qualsiasi punto e devono essere delimitati da "<!--" e "-->".
Ad esempio:
<!-- Install Office Enterprise 2007 -->
<Configuration Product="Enterprise" >
<!-- Set the product key -->
<PIDKEY Value="1234512345123451234512345" />
<Display
<!-- Turn off all Setup UI -->
Level="none"
<!-- Accept the EULA for the user -->
AcceptEula="Yes"
/>
</Configuration>
Ogni cartella di prodotto di Office contiene un file Config.xml predefinito, che è composto da un elemento Elemento Configuration con l'attributo Product impostato sul valore appropriato per il prodotto. Nell'elemento Elemento Configuration si trovano diversi elementi di esempio racchiusi in commenti. Per attivare questi elementi, rimuovere gli indicatori di commento iniziale e finale e immettere i valori di attributo appropriati.
Per attivare l'elemento Elemento PIDKEY, ad esempio, è possibile modificare:
<!-- <PIDKEY Value="BCDFGHJKMPQRTVWXY2346789B" /> -->
come segue:
<PIDKEY Value="1234567890123456789012345" />
Informazioni di riferimento sugli elementi di Config.xml
Nelle descrizioni di questa sezione di riferimento vengono utilizzate le convenzioni seguenti:
grassetto |
Nome di elemento o di attributo |
normale |
Testo da immettere esattamente come mostrato |
corsivo |
Segnaposto per un valore da aggiungere |
x|y |
Scelta tra più valori |
[x] |
Valore facoltativo |
Elemento Configuration
Elemento principale. È obbligatorio e tutti gli altri elementi devono comparire all'interno di esso.
Sintassi
<Configuration [Product="IDprodotto"] >
...
</Configuration>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Product |
IDprodotto |
Il valore dell'attributo ID nell'elemento Setup nel file setup.xml del prodotto da installare |
Osservazioni
L'attributo Product identifica il prodotto interessato dal file Config.xml. L'IDprodotto viene definito nel file Setup.xml della cartella principale del prodotto, nell'attributo ID dell'elemento Setup.
L'attributo Product è facoltativo, a meno che l'attributo Elemento DisplayLevel non sia impostato 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, il processo di installazione verrà interrotto.
Esempio
L'IDprodotto di Office Enterprise 2007 si trova in Enterprise.WW\Setup.xml nella riga seguente:
<Setup Id="Enterprise" Type="Product" ... >
Utilizzare questo IDprodotto in Config.xml per specificare Office Enterprise 2007 immettendo quanto segue:
<Configuration Product="Enterprise">
...
</Configuration>
Elemento AddLanguage
Aggiunge la lingua specificata all'installazione.
Sintassi
<AddLanguage
Id="ll-cc" | "match"
[ShellTransform="Yes"]
/>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Id |
ll - cc |
Identificatore di lingua. Per un elenco completo dei tag di lingua, vedere Identificatori di lingua in Office System 2007. |
match |
Corrisponde alla lingua delle impostazioni internazionali di Windows dell'utente. |
|
ShellTransform |
Yes |
Specifica la lingua dell'interfaccia utente della shell. Se vengono specificati più elementi AddLanguage, è necessario che una sola lingua specifichi l'elemento ShellTransform. |
Osservazioni
La lingua deve essere disponibile nel percorso di installazione di rete.
Sono possibili più elementi AddLanguage e Elemento RemoveLanguage. Se gli elementi Elemento RemoveLanguage e AddLanguage specificano la stessa lingua, l'elemento AddLanguage ha la priorità e la lingua viene installata.
[!NOTA] Se vengono specificati più elementi AddLanguage, è necessario che una sola lingua specifichi l'elemento ShellTransform. In caso contrario, il processo di installazione verrà interrotto.
Vi sono tre diversi concetti di lingua che è necessario conoscere per l'installazione di Office System 2007:
Interfaccia utente del programma di installazione: la lingua dell'installazione.
Interfaccia utente della shell: la lingua dei collegamenti, dei menu di scelta rapida e delle descrizioni comandi.
Interfaccia utente di Office: la lingua dell'interfaccia utente e dei menu di Office.
Quando vi sono più lingue di Office, questi tre valori vengono determinati come segue:
Per impostazione predefinita, l'interfaccia utente del programma di installazione dipende dalla serie di risorse disponibili per l'installazione e dalla possibilità di creare una corrispondenza alle impostazioni internazionali dell'utente. Per impostazione predefinita, l'interfaccia utente del programma di installazione corrisponde alle impostazioni internazionali dell'utente. L'interfaccia utente della shell dipende dalla serie di lingue installate e per impostazione predefinita corrisponde alla lingua dell'interfaccia utente del programma di installazione. La lingua predefinita dell'interfaccia utente di Office dipende dalle impostazioni internazionali e dalle impostazioni correnti dell'utente. Per impostazione predefinita, vengono utilizzate le impostazioni internazionali di Windows impostate sul computer dell'utente. In base alle impostazioni predefinite quindi l'interfaccia utente del programma di installazione, della shell e di Office utilizzeranno la stessa lingua.
Nei sistemi operativi Windows il termine impostazioni internazionali indica una serie di informazioni sulle preferenze dell'utente correlate alla lingua, all'ambiente e alle convenzioni culturali dell'utente. Queste informazioni sono rappresentate come un elenco di valori utilizzati per determinare la lingua di input, il layout di tastiera, l'ordinamento e il formato di numeri, date, valute e ora. Le impostazioni internazionali dell'utente sono impostazioni specifiche dell'utente che determinano i formati utilizzati come predefiniti per visualizzare data, ora, valuta, numeri e l'ordinamento del testo. Per ogni account creato su un computer vengono specificate le impostazioni internazionali.
Se un amministratore specifica più lingue per l'installazione nel file Config.xml, è necessario scegliere la lingua dell'interfaccia utente della shell dalla serie delle lingue di installazione. A tale scopo, l'amministratore specifica l'attributo ShellTransform dell'elemento AddLanguage nel file Config.xml. In questo modo si specifica la lingua che dovrà essere utilizzata dal programma di installazione per l'interfaccia utente della shell. Questa impostazione tuttavia non avrà necessariamente effetto sulla scelta dell'interfaccia utente dell'installazione o di Office all'installazione sul computer dell'utente.
Se ad esempio si dispone di un'immagine di Office con inglese, francese, tedesco e spagnolo, per specificare che il programma di installazione dovrà installare un supporto lingua completo per tutte queste lingue e l'interfaccia utente della shell dovrà seguire le impostazioni internazionali predefinite dell'utente, è necessario aggiungere gli elementi seguenti nel file Config.xml:
<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 corrisponderà alla lingua delle impostazioni internazionali dell'utente. Se nell'immagine di origine sono presenti più lingue, il valore match dell'esempio precedente potrebbe installare una lingua aggiuntiva nel caso in cui la lingua match non corrisponda a una delle quattro lingue indicate in modo esplicito. Se ad esempio nell'origine fosse incluso anche il giapponese, oltre alle quattro lingue indicate verrebbe installato anche il giapponese quando l'installazione viene eseguita su un computer con le impostazioni internazionali impostate sul giapponese.
Esempio
<AddLanguage Id="en-us" ShellTransform="Yes" />
Elemento ARP
Specifica valori che controllano il testo e il comportamento di Installazione applicazioni nel Pannello di controllo del prodotto.
Sintassi
<ARP attributo =" valore " [attributo**="valore"**] ... />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
ARPCOMMENTS |
testo |
Testo aggiuntivo. Può contenere un massimo di 255 caratteri, anche se è possibile che non vengano visualizzati tutti. |
ARPCONTACT |
testo |
Elenco di contatti di supporto tecnico. |
ARPNOMODIFY |
Yes |
Impedisce agli utenti di modificare l'installazione del prodotto rendendo non disponibile il pulsante Cambia. |
No (valore predefinito) |
Consente agli utenti di modificare l'installazione del prodotto. |
|
ARPNOREMOVE |
Yes |
Impedisce agli utenti di rimuovere il prodotto rendendo non disponibile il pulsante Rimuovi. |
No (valore predefinito) |
Consente agli utenti di rimuovere il prodotto. |
|
ARPURLINFOABOUT |
URL |
URL della home page del prodotto. |
ARPURLUPDATEINFO |
URL |
URL delle informazioni sugli aggiornamenti del prodotto. |
ARPHELPLINK |
URL |
URL di un sito Web da cui gli utenti possono ricevere supporto tecnico. |
ARPHELPTELEPHONE |
testo |
Numeri telefonici di supporto tecnico. |
Elemento CCP_DRIVE
Percorso completo della cartella in cui RMCCPSEARCH deve eseguire la ricerca. L'azione RMCCPSEARCH utilizza le firme dei file per verificare che nel sistema siano installati prodotti validi prima di installare un aggiornamento.
Sintassi
<CCP_DRIVE Value=" valore " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Value |
valore |
Percorso completo della cartella in cui RMCCPSEARCH esegue la ricerca |
Esempio
<CCP_DRIVE Value="\\server\office2003" />
Elemento Command
Specifica una riga di comando da eseguire. Per ulteriori informazioni, vedere la sezione Osservazioni.
| Suggerimento: |
|---|
| L'opzione equivalente nello Strumento di personalizzazione di Office è Aggiungi installazioni ed esegui programmi. |
Sintassi
<Command
Path="percorso"
[QuietArg="argomenti"]
[Args="argomenti"]
[ChainPosition="Before" | "After"(valore predefinito)]
[Wait="millisecondi"]
[Execute="Install"(valore predefinito) | "Uninstall"]
[Platform="x86"(valore predefinito) | "x64"]
/>
Attributi
Nella tabella seguente vengono descritti gli attributi dell'elemento Command.
| Attributo | Valore | Descrizione |
|---|---|---|
Path |
percorso |
Percorso completo del file eseguibile. Se il valore del percorso include uno spazio, è necessario utilizzare le virgolette doppie, come indicato nell'esempio seguente: "\\server\share\Office 12\copylogs.bat" |
QuietArg |
stringa |
Stringa di argomenti da aggiungere alla riga di comando se configura un'installazione invisibile all'utente. Per ulteriori informazioni su quando utilizzare l'attributo QuietArg, vedere la sezione Osservazioni dopo la tabella. |
Args |
stringa |
Stringa di argomenti da passare al file eseguibile. Per informazioni su quando utilizzare l'attributo Args per le installazioni concatenate, vedere la sezione Osservazioni dopo la tabella. Se il valore dell'elemento Args include virgolette doppie, è possibile racchiudere l'intero valore tra virgolette singole ('), come illustrato nell'esempio seguente: Args='"/valore parametro"' |
ChainPosition |
Before |
Questo comando viene eseguito prima dell'installazione del prodotto principale. |
After (valore predefinito) |
Questo comando viene eseguito dopo l'installazione del prodotto principale. |
|
Wait |
millisecondi |
Quando si esegue l'installazione di un prodotto con l'attributo Elemento DisplayLevel impostato su "full" o "basic", indica il numero di millisecondi di attesa dopo l'esecuzione del programma prima di continuare con l'installazione. Il valore predefinito è 0 (zero), ovvero nessun tempo di attesa. |
Execute |
Install (valore predefinito) |
Questo comando viene eseguito quando viene installato il prodotto principale. |
Uninstall |
Questo comando viene eseguito quando viene disinstallato il prodotto principale. |
|
Platform |
x86 (valore predefinito) |
Specifica che il programma richiede la piattaforma Intel x86. Questo comando viene eseguito solo se il computer in cui viene effettuata l'installazione è della piattaforma richiesta. |
x64 |
Specifica che il programma richiede un processore a 64 bit in grado di supportare le estensioni x64 per l'architettura x86. Questo comando viene eseguito solo se il computer in cui viene effettuata l'installazione è della piattaforma richiesta. |
Osservazioni
L'elemento Command del file Config.xml e l'opzione Aggiungi installazioni ed esegui programmi nello Strumento di personalizzazione di Office (le righe di comando immesse nelle finestre di dialogo Aggiungi voce programma e Modifica voce programma) consentono solo di eseguire installazioni e disinstallazioni iniziali di prodotti. I comandi dell'elemento Command vengono elaborati solo durante le installazioni e le disinstallazioni iniziali. Se vengono utilizzati per eseguire personalizzazioni dopo l'installazione iniziale, i comandi dell'elemento Command vengono ignorati.
È possibile specificare la riga di comando in modo da eseguire un comando arbitrario o un file eseguibile lightweight che si desidera eseguire quando viene installato il prodotto.
L'elemento Command nel file Config.xml e l'opzione Aggiungi installazioni ed esegui programmi nello Strumento di personalizzazione di Office non offrono le funzionalità di distribuzione del software disponibili in uno strumento di distribuzione e gestione del software aziendale, ad esempio la capacità di tenere traccia dello stato della distribuzione e di individuare e risolvere i problemi. È pertanto consigliabile limitare l'utilizzo dell'elemento Command nel file Config.xml e dell'opzione Aggiungi installazioni ed esegui programmi nello Strumento di personalizzazione di Office solo per l'esecuzione di file eseguibili lightweight o di comandi arbitrari che non apporteranno modifiche al computer o che non richiedono l'input dell'utente. È ad esempio possibile eseguire una utilità per copiare i registri o un comando per avviare una pagina iniziale 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 viene rilevato un errore imprevisto, l'installazione principale e l'installazione concatenata potrebbero non essere completate correttamente. Non è consigliabile pertanto utilizzare il concatenamento. Il metodo consigliato per l'installazione di più prodotti insieme in ambienti aziendali prevede l'utilizzo di un programma di gestione della distribuzione, ad esempio Microsoft System Center Configuration Manager 2007, Microsoft Systems Management Server (SMS) 2003 oppure uno strumento di terze parti anziché il concatenamento. |
Di seguito viene indicato l'utilizzo degli attributi Args e QuietArg:
L'attributo Args viene sempre aggiunto al comando, che può includere opzioni come "/install" o **"Company=**Società".
L'attributo QuietArg viene aggiunto inoltre se l'installazione viene eseguita in modalità invisibile all'utente (con l'elemento Display impostato come Display="none"). In questi casi è possibile specificare l'attributo QuietArg con l'opzione "/quiet", ad esempio: QuietArg="/quiet".
Le affermazioni seguenti si applicano all'attributo Wait:
L'impostazione dell'attributo Wait su 0 millisecondi indica nessuna attesa dopo l'esecuzione del programma e la possibilità di continuare subito l'installazione. Il comando verrà eseguito immediatamente e l'elaborazione proseguirà come previsto.
I codici restituiti vengono rispettati solo se il valore Wait è diverso da zero. Se si specifica 0, non vi sarà alcuna attesa per continuare l'installazione dopo l'esecuzione del programma specificato. In questo caso non vi saranno pertanto codici restituiti da segnalare.
Se si imposta l'attributo Wait su un valore positivo diverso da zero, l'attesa corrisponderà esattamente al numero di millisecondi specificati. Se il processo termina prima dell'intervallo di tempo specificato, l'installazione continuerà. Se invece il processo non è terminato dopo che è trascorso l'intervallo di tempo specificato, l'installazione avrà esito negativo.
Se si imposta l'attributo Wait su -1, l'attesa si estenderà per un periodo di tempo indeterminato. Questa impostazione può risultare problematica perché se il processo del comando smette di rispondere (si blocca), il programma di installazione non risponderà più e attenderà l'esecuzione del comando per un periodo di tempo indeterminato.
Se nel file Config.xml sono presenti due o più elementi Command, questi vengono eseguiti nell'ordine in cui sono specificati nel file Config.xml.
Esempi
<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="30000" />
Elemento COMPANYNAME
Nome dell'organizzazione o della società dell'utente sul cui computer viene installato il prodotto.
| Suggerimento: |
|---|
| L'opzione equivalente nello Strumento di personalizzazione di Office è l'impostazione Nome organizzazione in Percorso di installazione e nome organizzazione. |
Sintassi
<COMPANYNAME Value=" nomesocietà " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Value |
nomesocietà |
Nome della società o dell'organizzazione |
Esempio
<COMPANYNAME Value="Microsoft Corporation" />
Elemento Display
Livello di interfaccia utente visualizzato all'utente dal programma di installazione.
| Suggerimento: |
|---|
| Le opzioni equivalenti nello Strumento di personalizzazione di Office sono Livello visualizzazione e le impostazioni del contratto di licenza in “Licenze e interfaccia utente” in Strumento di personalizzazione di Office in Office System 2007. |
Sintassi
<Display
Level="None" | "Basic" | "Full"(valore predefinito)
CompletionNotice="Yes" | "No"(valore predefinito)
SuppressModal="Yes" | "No"(valore predefinito)
NoCancel="Yes" | "No"(valore predefinito)
AcceptEula="Yes" | "No"(valore predefinito)
/>
Attributi
| 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 (installazione automatica). Per ulteriori informazioni, vedere la sezione Osservazioni. |
Basic |
Il programma di installazione visualizza la schermata iniziale, la pagina relativa al codice "Product Key" (PIDKEY) (se necessario), la pagina del Contratto di licenza con l'utente finale (se necessario), un indicatore di stato e l'avviso di completamento (se consentito). |
|
Full (valore predefinito) |
Viene visualizzata l'interfaccia utente completa. |
|
CompletionNotice |
Yes |
Si applica solo se Level è impostato su "Basic" o "None". Viene visualizzato l'avviso di completamento. |
No (valore predefinito) |
Si applica solo se Level è impostato su "Basic". Non viene visualizzato l'avviso di completamento. |
|
SuppressModal |
Yes |
Si applica solo se Level è impostato su "Basic". Non vengono visualizzati messaggi di errore o altre finestre di dialogo che potrebbero interrompere l'installazione. |
No (valore predefinito) |
Si applica solo se Level è impostato su "Basic". Vengono visualizzati gli errori e le altre finestre di dialogo secondo i casi. |
|
NoCancel |
Yes |
Se Level è impostato su "Full" o "Basic", disabilita il pulsante di annullamento (X nell'angolo superiore destro della finestra di dialogo relativa allo stato). |
No (valore predefinito) |
Se Level è impostato su "Full" o "Basic", consente all'utente di annullare l'installazione dall'indicatore di stato. |
|
AcceptEULA |
Yes |
Il Contratto di licenza con l'utente finale viene accettato per conto dell'utente. La pagina del contratto non viene visualizzata. |
No (valore predefinito) |
Se Level è impostato su "None", viene visualizzata la pagina del Contratto di licenza con l'utente finale. |
Osservazioni
Se questo elemento non viene definito, vengono utilizzate le impostazioni predefinite. Se viene specificato un valore non valido, l'installazione viene interrotta.
Se l'attributo Level è impostato su "Basic" o "None" e si specifica un codice "Product Key" utilizzando l'elemento Elemento PIDKEY, il programma di installazione presupporrà che vengano accettate anche le condizioni di licenza per conto del'utente.
[!NOTA] Nelle distribuzioni aziendali è consigliabile impostare Display Level su none per fare in modo che il programma di installazione venga eseguito in modalità invisibile all'utente, evitando così che venga richiesto di immettere informazioni e che venga attesa l'interazione dell'utente, anche quando i file sono in uso. Se Display Level viene impostato su none, gli attributi SuppressModal e CompletionNotice si intendono disattivati e il Contratto di licenza con l'utente finale si intende accettato. Gli amministratori devono assicurarsi che nessuna applicazione di Office sia in esecuzione durante l'installazione di Office System 2007.
Se si imposta Display level su basic e SuppressModal su yes, è possibile che venga visualizzata una richiesta di conferma agli utenti nel caso in cui un file di Office sia in uso. L'impostazione di Display level su none evita che vengano visualizzate richieste di conferma in questi casi. L'attributo SuppressModal non impedisce la visualizzazione di messaggi relativi ai file in uso. Tali messaggi non vengono visualizzati solo se si imposta Display level su none.
L'elemento Display viene utilizzato dal programma di installazione solo se il file Config.xml viene trovato nella stessa cartella di setup.exe oppure se si specifica il file Config.xml mediante l'opzione della riga di comando /config del programma di installazione. Se il programma di installazione utilizza il file Config.xml nella cartella del prodotto, verranno utilizzate le opzioni di visualizzazione predefinite.
Esempio
<Display Level="none" AcceptEula="Yes" />
Elemento DistributionPoint
Specifica il percorso completo del punto di installazione di rete da cui deve essere eseguita l'installazione.
Sintassi
<DistributionPoint Location=" percorso " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Location |
percorso |
Percorso completo del punto di installazione di rete da cui deve essere eseguita l'installazione |
Osservazioni
Se questo non è specificato, il programma di installazione presuppone che il file Setup.exe si trovi alla radice del punto di installazione di rete.
[!NOTA] L'elemento DistributionPoint viene utilizzato dal programma di installazione solo se il file Config.xml viene trovato nella stessa cartella di Setup.exe oppure se si specifica il file Config.xml mediante l'opzione della riga di comando /config del programma di installazione. Se il programma di installazione utilizza il file Config.xml nella cartella del prodotto, questo elemento verrà ignorato, perché il punto di installazione di rete è già stato trovato.
Esempio
<DistributionPoint Location="\\server1\office" />
Elemento INSTALLLOCATION
Specifica il percorso completo della cartella sul computer dell'utente in cui viene installato il prodotto.
| Suggerimento: |
|---|
| L'opzione equivalente nello Strumento di personalizzazione di Office è l'impostazione Percorso di installazione predefinito in Percorso di installazione e nome organizzazione. |
Sintassi
<INSTALLLOCATION Value=" percorso " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Value |
percorso |
Percorso completo della cartella sul computer dell'utente in cui viene installato il prodotto. |
Osservazioni
È possibile utilizzare le variabili di ambiente del sistema nel percorso. Se questo elemento non è specificato, Office viene installato in %ProgramFiles%\Microsoft Office.
Esempio
<INSTALLLOCATION VALUE="%ProgramFiles%\MyApps" />
Elemento LIS
Controlla come l'origine di installazione locale è memorizzata nella cache sul computer dell'utente e specifica la posizione di uno o più punti di installazione di rete che contengono i file di installazione del prodotto.
Sintassi
<LIS
[CACHEACTION="CacheOnly" | "RemoveCacheOnly"]
[SOURCELIST=" elenco-percorso-delimitato-punto-e-virgola "]
/>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
CACHEACTION |
CacheOnly |
Imposta copie dell'origine di installazione locale sul computer dell'utente, senza installare il prodotto. |
RemoveCacheOnly |
Se la cache viene copiata sul computer dell'utente e Office non viene installato, il programma di installazione rimuove l'origine di installazione locale dal computer dell'utente senza installare né disinstallare il prodotto. |
|
SOURCELIST |
elenco-percorso-delimitato-punto-e-virgola |
Elenco, separato da punto e virgola, di una o più posizioni di installazione di rete che contengono i file di installazione del prodotto. L'opzione equivalente nello Strumento di personalizzazione di Office è Origini di rete aggiuntive. |
Osservazioni
Per impostazione predefinita, l'origine di installazione locale viene creata nella cartella \MsoCache\All Users nella radice dell'unità in cui è installato Office. Vengono inoltre copiati i file di personalizzazione dell'installazione e gli aggiornamenti software nella cartella Updates nel punto di installazione di rete.
Se si specifica Elemento INSTALLLOCATION, l'indicazione di unità nel percorso viene utilizzata per stabilire in quale unità viene creata l'origine di installazione locale. Se ad esempio il percorso Elemento INSTALLLOCATION è E:\office\files, l'origine di installazione locale viene creata nell'unità E. Le origini elencate dall'attributo SOURCELIST vengono mantenute con il prodotto installato e vengono utilizzate dal programma di installazione se l'origine di installazione locale del computer dell'utente è mancante o danneggiata.
Esempio
<LIS CACHEACTION="CacheOnly" />
<LIS SOURCELIST="\\server1\office;\\server2\corpdata" />
Elemento Logging
Specifica il tipo di registrazione effettuata dal programma di installazione.
Sintassi
<Logging
Type="Off" | "Standard"(valore predefinito) | "Verbose"
Path="percorso"
Template="nomefile.txt"
/>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Type |
Off |
Non viene effettuata alcuna registrazione. |
Standard (valore predefinito) |
Nel file di registro vengono scritte alcune informazioni relative all'installazione. |
|
Verbose |
Non file di registro vengono scritte tutte le informazioni relative all'installazione. |
|
Path |
percorso |
Percorso completo della cartella utilizzata per il file di registro. È possibile utilizzare variabili di ambiente. Il valore predefinito è %temp%. |
Template |
nomefile .txt |
Nome del file di registro. Se si inserisce la stringa * in un punto qualsiasi del nome del file, verrà creato un file di registro per ogni installazione eseguita da Setup.exe (vedere più avanti la descrizione specifica). Se non si inserisce * e il nome del file specificato esiste già, le informazioni di registrazione verranno aggiunte alla fine del file esistente. È necessario includere l'estensione txt del file. Il modello predefinito è SetupExe(*).log. |
Osservazioni
È possibile specificare * in qualsiasi punto del valore Template. In tale punto verrà quindi inserita una stringa nel formato seguente:
YYYYMMDDHHMMSS xxx
dove:
YYYY = Anno
MM = Mese
DD = Giorno
HH = Ora
MM = Minuto
SS = Secondi
xxx = stringa univoca generata dal programma di installazione
[!NOTA] L'elemento Logging viene utilizzato dal programma di installazione solo se il file Config.xml viene trovato nella stessa cartella di Setup.exe oppure se si specifica il file Config.xml mediante l'opzione della riga di comando /config del programma di installazione. Se il programma di installazione utilizza il file Config.xml nella cartella del prodotto, verranno utilizzate le opzioni di registrazione predefinite.
Esempio
<Logging Type="standard" Path="%temp%"
Template="MyLog(*).txt"
/>
Con questo esempio viene creato un file di registro ogni volta che si installa il prodotto. Verranno utilizzati nomi di file univoci, come mostrato di seguito:
%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt
Elemento MinOSRequirement
Specifica il sistema operativo minimo supportato per il prodotto.
Sintassi
<MinOSRequirement
VersionNT="versione"
WindowsBuild="numero"
ServicePackLevel="numero"
/>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
VersionNT |
versione |
Versione Windows NT |
WindowsBuild |
numero |
Numero della build di Windows |
ServicePackLevel |
numero |
Numero del service pack di Windows |
È possibile utilizzare i valori seguenti.
| System | VersionNT | WindowsBuild | ServicePackLevel |
|---|---|---|---|
Windows XP |
501 |
2600 |
2 o versione successiva |
Windows Server 2003 |
502 |
3790 |
0 o versione successiva |
Osservazioni
L'installazione non viene eseguita se il sistema operativo installato sul computer dell'utente è di una versione precedente a quella specificata (o alla versione predefinita di Office se questo elemento non è specificato). Non è possibile specificare qui una versione di Microsoft Windows precedente alla versione richiesta da Office System 2007.
Per informazioni sui requisiti di sistema, vedere Guida introduttiva a Office System 2007.
Elemento OptionState
Indica come caratteristiche specifiche del prodotto vengono gestite durante l'installazione.
| Importante: |
|---|
| Nella maggior parte dei casi è consigliabile utilizzare lo Strumento di personalizzazione di Office per modificare lo stato di installazione delle caratteristiche. L'opzione equivalente nello Strumento di personalizzazione di Office è Imposta stato di installazione caratteristiche. |
Sintassi
<OptionState
Id="IDopzione"
State="Absent" | "Advertise" | "Default" | "Local"
[Children="force"]
/>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Id |
IDopzione |
Elemento che l'utente può scegliere di installare. |
State |
Absent |
La caratteristica non viene installata. |
Advertise |
La caratteristica viene installata al primo utilizzo. |
|
Default |
La caratteristica ritorna allo stato di installazione predefinito. |
|
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.
Per un elenco dei valori Id di OptionState, vedere Valori ID OptionState del file Config.xml. Per informazioni su come modificare l'elemento OptionState in Config.xml, vedere la sezione Modifica dell'elemento OptionState del file Config.xml in Utilizzare Criteri di gruppo Installazione software per distribuire Office System 2007.
Esempio
<OptionState Id="ExcelAddinFiles"
State="Absent"
Children="force"
/>
Elemento PIDKEY
Codice "Product Key" di 25 caratteri per licenze Volume License.
| Suggerimento: |
|---|
| L'opzione equivalente nello Strumento di personalizzazione di Office è l'impostazione Codice "Product key" in “Licenze e interfaccia utente” in Strumento di personalizzazione di Office in Office System 2007. |
Sintassi
<PIDKEY Value=" codice-di-25-caratteri " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Value |
codice-di-25-caratteri |
Codice Volume License di 25 caratteri |
Osservazioni
Quando viene impostato il valore PIDKEY, gli utenti non devono immettere un codice "Product Key" durante l'installazione di Office.
Esempio
<PIDKEY Value="1234512345123451234512345" />
[!NOTA] Se l'attributo Level dell'elemento Elemento Display è impostato su "Basic" o "None" e si specifica un codice "Product Key" utilizzando l'elemento PIDKEY, il programma di installazione presupporrà che venga accettato anche il contratto di licenza per conto dell'utente. In tale caso, indipendentemente dall'impostazione dell'attributo AcceptEULA dell'elemento Elemento Display, l'approvazione del contratto di licenza non verrà richiesta all'utente durante l'installazione né al primo avvio di un'applicazione di Office.
Elemento RemoveLanguage
Rimuove la lingua specificata dall'installazione.
Sintassi
<RemoveLanguage Id=" ll - cc " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Id |
ll-cc |
Identificatore di lingua. Per un elenco completo dei tag di lingua, vedere Identificatori di lingua in Office System 2007. |
Osservazioni
Se la lingua non è installata sul computer dell'utente, l'elemento RemoveLanguage viene ignorato.
Sono possibili più elementi Elemento AddLanguage e RemoveLanguage. Se gli elementi RemoveLanguage e Elemento AddLanguage specificano la stessa lingua, l'elemento Elemento AddLanguage ha la priorità 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 Strumento di personalizzazione di Office in Office System 2007. |
Sintassi
<Setting Id=" nome " Value=" valore " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Id |
nome |
Nome della proprietà di Windows Installer. |
Value |
valore |
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 viene interrotto. Se viene specificata una proprietà supportata, tale proprietà viene passata direttamente a Windows Installer. Per un elenco completo delle proprietà di Windows Installer, inclusa una spiegazione delle proprietà supportate e bloccate, vedere Proprietà di installazione in Office System 2007.
L'elemento Setting supporta l'impostazione REMOVEPREVIOUS. Questa impostazione rimuove dall'installazione l'applicazione specificata e utilizza la sintassi seguente:
<Setting Id="REMOVEPREVIOUS" Value="Option Id" />
dove Id opzione è il valore dell'identificatore per l'applicazione di Office System 2007. Per specificare più applicazioni, utilizzare un elenco delimitato da virgole per indicare i valori appropriati per Id opzione. Per un elenco completo di valori di Id opzione, vedere Valori ID OptionState del file Config.xml.
[!NOTA] Se si installa Outlook, l'eventuale versione precedentemente installata di Outlook viene sempre rimossa, indipendentemente dalle preferenze dell'utente.
Se si specifica REMOVEPREVIOUS con un valore Id opzione, vengono rimosse solo le applicazioni specificate.
Se non si specifica REMOVEPREVIOUS, vengono rimosse tutte le applicazioni di Office installate in precedenza per cui viene installato un sostituto. Questo è il comportamento predefinito.
Se si specifica REMOVEPREVIOUS senza specificare alcun valore (REMOVEPREVIOUS=""), non viene rimossa alcuna applicazione.
L'elemento Setting supporta anche la proprietà SETUP_REBOOT. SETUP_REBOOT dà inizio a un riavvio dopo l'installazione e utilizza la sintassi seguente:
<Setting Id="SETUP_REBOOT" Value="value" />
dove valore può essere uno dei seguenti:
AutoAlways--Esegui sempre il riavvio senza chiedere conferma all'utente.
Always--Richiedi sempre il riavvio al termine dell'installazione.
IfNeeded--Richiedi il riavvio al termine dell'installazione se necessario (impostazione predefinita).
AutoIfNeeded--Riavvia se necessario per l'installazione senza chiedere conferma all'utente.
Never--Non riavviare e non richiedere il riavvio.
Esempi
<Setting Id="SETUP_REBOOT" Value="NEVER" />
<Setting Id="REMOVEPREVIOUS" Value="WORDFiles" />
Elemento SetupUpdates
Specifica il percorso di ricerca che il processo di installazione deve utilizzare per cercare i file di personalizzazione dell'installazione
Sintassi
<SetupUpdates
[CheckForSUpdates="Yes"(valore predefinito) | "No"]
[SUpdateLocation="elenco-percorsi"]
/>
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
CheckForSUpdates |
Yes (valore predefinito) |
Il programma di installazione utilizza l'elenco dei percorsi in SUpdateLocation per trovare i file di personalizzazione dell'installazione. |
No |
Il programma di installazione non cerca i file di personalizzazione dell'installazione nell'elenco dei percorsi in SUpdateLocation. |
|
SUpdateLocation |
elenco-percorsi |
Elenco dei percorsi completi delle cartelle, separati da punti e virgola. |
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 del file. Se un file di personalizzazione dell'installazione è stato specificato alla riga di comando del programma di installazione, tale file viene 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 sul cui computer viene installato il prodotto.
Sintassi
<USERINITIALS Value=" valore " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Value |
valore |
Iniziali dell'utente |
Esempio
<USERINITIALS Value="JD" />
Elemento USERNAME
Nome dell'utente sul cui computer viene installato il prodotto.
Sintassi
<USERNAME Value=" valore " />
Attributi
| Attributo | Valore | Descrizione |
|---|---|---|
Value |
valore |
Nome dell'utente. |
Osservazioni
I dati dell'elemento Username di Office 2007 vengono popolati come descritto di seguito.
Se l'utente che esegue Office è lo stesso che ha eseguito l'installazione, vengono utilizzati i valori Username e Initials forniti durante l'installazione. Non viene visualizzata nessuna richiesta al primo avvio di Office. Questo è in genere quanto avviene per gli utenti domestici che eseguono personalmente l'installazione di Office.
Se l'utente che esegue Office non è l'utente che ha eseguito l'installazione, al primo avvio di Office verrà chiesto di confermare i valori Username e Initials. Questo avviene in genere negli ambienti aziendali, dove l'installazione di Office sui computer degli utenti viene eseguita dall'amministratore.
Il valore dell'elemento Username visualizzato all'utente al primo avvio può essere prepopolato con un valore predefinito di una versione di Office installata in precedenza o dell'utente corrente che ha eseguito l'accesso. Si noti che il valore predefinito non viene utilizzato se non è confermato dall'utente. Se sul computer è installata una versione precedente di Office, viene utilizzata la chiave del Registro di sistema creata dalla versione precedente di Office. Se ad esempio l'installazione precedente di Office è Office 2003, la chiave del Registro di sistema viene fornita in HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\UserInfo.
Esempio
<USERNAME Value="John Doe" />
File Config.xml di esempio
Nell'esempio riportato di seguito viene illustrato un file Config.xml di un'installazione tipica. Viene utilizzata la versione Microsoft Office Enterprise 2007 del prodotto.
[!NOTA] La versione fornita di questo file ha utilizzato
Command Path="msiexec.exe". Nell'esempio seguente viene utilizzato il percorso completo del file msiexec.exe:Command Path="%WINDIR%\system32\msiexec.exe"
dove %WINDIR% è la cartella contenente i file di Windows. È necessario includere il percorso completo per eseguire il comando. In caso contrario, non sarà possibile eseguirlo.
<Configuration Product="Enterprise">
<!-- <Display Level="full" CompletionNotice="yes" SuppressModal="no" AcceptEula="no" /> -->
<!-- <Logging Type="verbose" Path="%temp%" Template="Microsoft Office Enterprise Setup(*).txt" /> -->
<!-- <PIDKEY Value="BCDFGHJKMPQRTVWXY2346789B" /> -->
<!-- <USERNAME Value="Customer" /> -->
<!-- <COMPANYNAME Value="MyCompany" /> -->
<!-- <INSTALLLOCATION Value="%programfiles%\Microsoft Office" /> -->
<!-- <LIS CACHEACTION="CacheOnly" /> -->
<!-- <DistributionPoint Location="\\server\share\Office12" /> -->
<!-- <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>
Scaricare il manuale
Questo articolo è incluso nel manuale seguente, che può essere scaricato per una lettura e una stampa più agevoli:
Informazioni di riferimento tecniche per la versione 2007 di Office(informazioni in lingua inglese)
Per un elenco completo dei manuali disponibili, vedere la pagina di informazioni sul contenuto scaricabile di Office Resource Kit 2007.
Vedere anche
Concetti
Panoramica dell'architettura di installazione per Office System 2007
Strumento di personalizzazione di Office in Office System 2007
Proprietà di installazione in Office System 2007
Distribuire configurazioni personalizzate di Office System 2007 (procedura dettagliata)
Procedure consigliate per la gestione di Office System 2007