Opzioni della riga di comando
Il programma eseguibile che interpreta i pacchetti e installa i prodotti è Msiexec.exe. Si noti che Msiexec imposta anche un livello di errore in caso di restituzione che corrisponde ai codici di errore di sistema. Le opzioni della riga di comando non fanno distinzione tra maiuscole e minuscole.
Le opzioni della riga di comando nella tabella seguente sono disponibili con Windows Installer 3.0 e versioni precedenti. Le opzioni del programma di installazione standard Command-Line sono disponibili anche a partire da Windows Installer 3.0.
| Opzione | Parametri | Significato |
|---|---|---|
| /Ho | Pacchetto |Productcode | Installa o configura un prodotto. |
| /F | [p|o|e|d|c|a|u|m|s|v] Pacchetto|Productcode | Ripara un prodotto. Questa opzione ignora tutti i valori delle proprietà immessi nella riga di comando. L'elenco di argomenti predefinito per questa opzione è 'omus'. Questa opzione condivide lo stesso elenco di argomenti della proprietà REINSTALLMODE . p : reinstalla solo se manca il file. o - Reinstalla se il file non è presente o se è installata una versione precedente. e : reinstalla se il file è mancante o se è installata una versione precedente o uguale a quella precedente. d - Reinstalla se il file è mancante o se è installata una versione diversa. c - Reinstalla se il file è mancante o il checksum archiviato non corrisponde al valore calcolato. Ripristina solo i file con msidbFileAttributesChecksum nella colonna Attributi della tabella File . a : forza la reinstallazione di tutti i file. u - Riscrive tutte le voci del Registro di sistema specifiche dell'utente necessarie. m : riscrive tutte le voci del Registro di sistema specifiche del computer necessarie. s : sovrascrive tutti i collegamenti esistenti. v: viene eseguito dall'origine e memorizza nuovamente nella cache il pacchetto locale. Non usare l'opzione di reinstallazione v per la prima installazione di un'applicazione o di una funzionalità. |
| /a | Pacchetto |
Opzione di installazione amministrativa . Installa un prodotto in rete. |
| /X | Pacchetto |Productcode | Disinstalla un prodotto. |
| /J | [u|m] Packageor [u|m] Elenco trasformazionipacchetto/t or [u|m] LanguageID pacchetto/g |
Annuncia un prodotto. Questa opzione ignora tutti i valori delle proprietà immessi nella riga di comando. u : annuncia all'utente corrente. m : annuncia a tutti gli utenti del computer. g - Identificatore lingua. t : applica la trasformazione al pacchetto annunciato. |
| /L | [i|w|e|a|r|u|c|m|o|p|v|x|+|!|*] File di log | Scrive le informazioni di registrazione in un file di log nel percorso esistente specificato. Il percorso del file di log deve esistere già. Il programma di installazione non crea la struttura di directory per il file di log. I flag indicano quali informazioni registrare. Se non vengono specificati flag, il valore predefinito è 'iwearmo'. i - Messaggi di stato. w - Avvisi non irreversibili. e - Tutti i messaggi di errore. a - Avvio delle azioni. r - Record specifici dell'azione. u - Richieste utente. c - Parametri iniziali dell'interfaccia utente. m : informazioni di uscita insufficiente o irreversibili. o - Messaggi di spazio su disco insufficiente. p - Proprietà del terminale. v : output dettagliato. x - Informazioni di debug aggiuntive. Windows Installer 2.0: Non supportato. L'opzione x è disponibile con Windows Installer versione 3.0.3790.2180 e successive. + - Accoda al file esistente. ! - Scaricare ogni riga nel log. "*" - Carattere jolly, registra tutte le informazioni ad eccezione delle opzioni v e x. Per includere le opzioni v e x, specificare "/l*vx".
Nota: |
| /M |
Filename
Nota: |
Genera un file con estensione mif di stato SMS. Deve essere usato con le opzioni di installazione (-i), remove (-x), installazione amministrativa (-a) o reinstallazione (-f). Il ISMIF32.DLL viene installato come parte di SMS e deve trovarsi nel percorso. I campi del file mif di stato sono compilati con le informazioni seguenti: Produttore - Autore Product - Numero revisione Versione - Oggetto Impostazioni locali - Modello Numero di serie - non impostato Installazione: impostata da ISMIF32.DLL su "DateTime" InstallStatus - "Operazione riuscita" o "Non riuscita" Descrizione- Messaggi di errore nell'ordine seguente: 1) Messaggi di errore generati dal programma di installazione. 2) Risorsa da Msi.dll se l'installazione non può iniziare o uscire dall'utente. 3) File del messaggio di errore di sistema. 4) Messaggio formattato: "Errore del programma di installazione %i", dove %i viene restituito da Msi.dll. |
| /p | PatchPackage[;p atchPackage2 ] | Applica una patch. Per applicare una patch a un'immagine amministrativa installata, è necessario combinare le opzioni seguenti: /p <PatchPackage>[;p atchPackage2 ] /a \<Package> |
| /q | n|b|r|f | Imposta il livello dell'interfaccia utente. q , qn - Nessuna interfaccia utente qb - Interfaccia utente di base. Usare qb! per nascondere il pulsante Annulla . qr - Interfaccia utente ridotta senza finestra di dialogo modale visualizzata alla fine dell'installazione. qf : interfaccia utente completa e qualsiasi finestra di dialogo modale FatalError, UserExit o Exit creata alla fine. qn+ - Nessuna interfaccia utente ad eccezione di una finestra di dialogo modale visualizzata alla fine. qb+ - Interfaccia utente di base con una finestra di dialogo modale visualizzata alla fine. La casella modale non viene visualizzata se l'utente annulla l'installazione. Usare qb+! o qb!+ per nascondere il pulsante Annulla . qb- - Interfaccia utente di base senza finestre di dialogo modali. Si noti che /qb+- non è un livello di interfaccia utente supportato. Usare qb-! o qb!: per nascondere il pulsante Annulla . Si noti che ! l'opzione è disponibile con Windows Installer 2.0 e funziona solo con l'interfaccia utente di base. Non è valido con l'interfaccia utente completa. |
| /? o /h | Visualizza le informazioni sul copyright per Windows Installer. |
|
| /Y | Modulo | Chiama la funzione di sistema DllRegisterServer per registrare automaticamente i moduli passati nella riga di comando. Specificare il percorso completo della DLL. Ad esempio, per MY_FILE.DLL nella cartella corrente è possibile usare: msiexec /y .\MY_FILE.DLL Questa opzione viene utilizzata solo per le informazioni del Registro di sistema che non possono essere aggiunte utilizzando le tabelle del Registro di sistema del file .msi. |
| /Z | Modulo | Chiama la funzione di sistema DllUnRegisterServer per annullare la registrazione dei moduli passati nella riga di comando. Specificare il percorso completo della DLL. Ad esempio, per MY_FILE.DLL nella cartella corrente è possibile usare: msiexec /z .\MY_FILE.DLL Questa opzione viene utilizzata solo per le informazioni del Registro di sistema che non possono essere rimosse utilizzando le tabelle del Registro di sistema del file .msi. |
| /C | Annuncia una nuova istanza del prodotto. Deve essere usato in combinazione con /t. Disponibile a partire dalla versione di Windows Installer fornita con Windows Server 2003 e Windows XP con Service Pack 1 (SP1). |
|
| /N | ProductCode | Specifica una particolare istanza del prodotto. Usato per identificare un'istanza installata usando il supporto di più istanze tramite trasformazioni di modifica del codice prodotto. Disponibile a partire dalla versione di Windows Installer fornita con Windows Server 2003 e Windows XP con SP1. |
Le opzioni /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a, /p, /y e /z non devono essere usate insieme. L'unica eccezione a questa regola è che l'applicazione di patch a un'installazione amministrativa richiede l'uso di /p e /a. Le opzioni /t, /c e /g devono essere usate solo con /j. Le opzioni /l e /q possono essere usate con /i, /x, /f[p|o|e|d|c|a|u|m|s|v], /j[u|m], /a e /p. L'opzione /n può essere usata con /i, /f, /x e /p.
Per installare un prodotto da A:\Example.msi, installare il prodotto come indicato di seguito:
msiexec /i A:\Example.msi
È possibile modificare solo le proprietà pubbliche tramite la riga di comando. Tutti i nomi di proprietà nella riga di comando vengono interpretati come maiuscoli, ma il valore mantiene la distinzione tra maiuscole e minuscole. Se si immette MyProperty in una riga di comando, il programma di installazione sostituisce il valore di MYPROPERTY e non il valore di MyProperty nella tabella Proprietà. Per altre informazioni, vedere Informazioni sulle proprietà.
Per installare un prodotto con PROPERTY impostato su VALUE, usare la sintassi seguente nella riga di comando. È possibile inserire la proprietà in qualsiasi punto tranne tra un'opzione e il relativo argomento.
Sintassi corretta:
msiexec /i A:\Example.msi PROPERTY=VALUE
Sintassi errata:
msiexec /i PROPERTY=VALUE A:\Example.msi
I valori delle proprietà che sono stringhe letterali devono essere racchiusi tra virgolette. Includere spazi vuoti nella stringa tra i contrassegni.
msiexec /i A:\Example.msi PROPERTY="Spazio vuoto incorporato"
Per cancellare una proprietà pubblica usando la riga di comando, impostarne il valore su una stringa vuota.
msiexec /i A:\Example.msi PROPERTY=""
Per le sezioni di testo separate da virgolette letterali, racchiudere la sezione con una seconda coppia di virgolette.
msiexec /i A:\Example.msi PROPERTY="Embedded "Quotes"" White Space"
L'esempio seguente mostra una riga di comando complicata.
msiexec /i testdb.msi INSTALLLEVEL=3 /l* msi.log COMPANYNAME="Acme ""Widgets"" e ""Gizmos."""
L'esempio seguente mostra le opzioni degli annunci pubblicitari. Si noti che le opzioni non fanno distinzione tra maiuscole e minuscole.
msiexec /JM msisample.msi /T transform.mst /LIME logfile.txt
Nell'esempio seguente viene illustrato come installare una nuova istanza di un prodotto da annunciare. Questo prodotto viene creato per supportare più trasformazioni di istanza.
msiexec /JM msisample.msi /T :instance1.mst;customization.mst /c /LIME logfile.txt
Nell'esempio seguente viene illustrato come applicare patch a un'istanza di un prodotto installato usando più trasformazioni di istanza.
msiexec /p msipatch.msp;msipatch2.msp /n {00000001-0002-0000-0000-624474736554} /qb
Quando si applicano patch a un prodotto specifico, le opzioni /i e /p non possono essere specificate insieme in una riga di comando. In questo caso, è possibile applicare patch a un prodotto come indicato di seguito.
msiexec /i A:\Example.msi PATCH=msipatch.msp;msipatch2.msp /qb
Non è possibile impostare la proprietà PATCH in una riga di comando quando viene utilizzata l'opzione /p. Se la proprietà PATCH viene impostata quando viene utilizzata l'opzione /p, il valore della proprietà PATCH viene ignorato e sovrascritto.