Opcje i właściwość wiersza polecenia Instalatora

Podczas uruchamiania Instalatora można używać opcji wiersza polecenia, aby zmieniać niektóre parametry używane przez Instalatora do instalacji aplikacji, na przykład ustawienia wyświetlania i domyślne wartości właściwości Instalatora.

Instalator i Instalator Windows korzystają z właściwości do kontroli procesu instalacji aplikacji. Domyślne wartości właściwości Instalatora są określone w pakiecie Instalatora Windows (plik MSI). Nowe wartości właściwości można określić za pomocą wiersza polecenia lub w pliku ustawień Instalatora (Setup.ini).

Uwaga   W większości przypadków opcje wiersza polecenia zastępują powielone zmiany, wprowadzone w pliku ustawień Instalatora (Setup.ini) lub w transformacji (plik MST). Opcje i właściwości wiersza polecenia nie są obsługiwane przez wszystkie pliki MSI.

 

/a

/f

/i

/j

/l

/noreboot

/p

/q

/settings

/x

właściwość=wartość

/?

 

/a [plik_msi]

Utwórz punkt instalacji administracyjnej dla określonego pakietu (pliku MSI). Pakiet musi znajdować się w tym samym folderze, co plik Setup.exe, oba pliki muszą znajdować się w katalogu głównym punktu instalacji administracyjnej.

Przykłady:

/a MójPlik.msi

/a "podfolder1\MójPlik.msi"

/f[opcje][plik_msi]

Wymuś naprawę aplikacji skojarzonej z określonym pakietem (plikiem MSI). Pakiet musi znajdować się w tym samym folderze, co plik Setup.exe, oba pliki muszą znajdować się w katalogu głównym punktu instalacji administracyjnej. Można również określić kod produktu pakietu. Kod produktu można skopiować z sekcji [Product] pliku ustawień Instalatora .

Uwaga   Należy określić ten sam pakiet, który oryginalnie był używany do instalacji aplikacji.

<i>Opcje</i> mogą przyjmować następujące wartości:

a Wymuś ponowną instalację wszystkich plików, niezależnie od sumy kontrolnej lub wersji.
c Zainstaluj ponownie plik, jeśli go brakuje lub jest on uszkodzony.
d Zainstaluj ponownie plik, jeśli go brakuje lub obecna jest inna wersja.
e Zainstaluj ponownie plik, jeśli go brakuje albo obecna jest identyczna lub starsza wersja.
m Zapisz ponownie wszystkie wymagane wpisy w kluczu rejestru HKEY_LOCAL_MACHINE.
o Zainstaluj ponownie plik, jeśli go brakuje lub obecna jest starsza wersja.
p Zainstaluj ponownie plik, tylko jeśli go brakuje.
s Zainstaluj ponownie wszystkie skróty i zastąp istniejące skróty.
u Zapisz ponownie wszystkie wymagane wpisy w kluczu rejestru HKEY_CURRENT_USER.
v Pobierz pakiet z oryginalnego źródła i ponownie umieść go w pamięci podręcznej na komputerze lokalnym.

Polecenie Wykryj i napraw w aplikacjach pełni tą samą funkcję co opcja /focums. Uruchomienie Instalatora i wybranie ponownej instalacji pełni tą samą funkcję co opcja /fecums. W trakcie instalacji Instalator Windows zapisuje plik MSI na komputerze lokalnym. Jeśli użyta zostanie opcja /fvm w celu wymuszenia ponownego umieszczenia w pamięci podręcznej i ponownej instalacji, Instalator Windows pobiera plik MSI z oryginalnego źródła i ponownie umieszcza go w pamięci podręcznej komputera lokalnego. Opcji /fvm można użyć do uaktualnienia komputerów klienckich po zainstalowaniu poprawki w punkcie instalacji administracyjnej.

Ważne Jeśli użytkownik instaluje na komputerze poprawki klienckie (binarne), nie można użyć opcji /f w celu ponownego umieszczenia w pamięci podręcznej i ponownej instalacji z uaktualnionego punktu instalacji administracyjnej. W takim przypadku użytkownicy muszą dokonać deinstalacji i ponownej instalacji z uaktualnionego obrazu administracyjnego.

Przykład:

/fpiwae MójPlik.msi

/fvm {12345678-1234-1234-1234-123456789123}

/i [plik_msi]

Zainstaluj aplikację przy użyciu określonego pakietu. Pakiet musi znajdować się w tym samym folderze, co plik Setup.exe.

Uwaga Domyślnie plik Setup.exe nakazuje Instalatorowi Windows wykonanie takiej samej czynności, jak przy użyciu opcji /i.

Przykłady:

/i MójPlik.msi

/i "podfolder1\MójPlik.msi"

/j[opcja] [plik_msi] [/t plik_mst]

Zaanonsuj aplikację na komputerze i zainstaluj przy pierwszym użyciu. Należy określić opcję anonsowania aplikacji na komputerze lub użytkownikowi. Opcji /j można używać tylko przy uruchamianiu Instalatora z punktu instalacji administracyjnej lub obrazu dysku CD w sieci. Jeśli nie został określony żaden pakiet, Instalator używa pakietu określonego w pliku Setup.ini. Aby dokonać transformacji aplikacji zaanonsowanej, należy użyć opcji /t i określić plik MST.

Opcje mogą przyjmować następujące wartości:

m Zaanonsuj wszystkim użytkownikom komputera.
u Zaanonsuj bieżącemu użytkownikowi.

Uwaga   Oprócz opcji /t można użyć następujących trzech opcji wiersza polecenia, gdy używana jest opcja /j do anonsowania aplikacji: /l, /q i /settings.

Przykład:

/jm MójPlik.msi /t Niestandardowa.mst

/l[opcje] plik_dziennika

Utwórz dziennik czynności instalacyjnych dla Instalatora i plik dziennika dla każdego zadania Instalatora Windows. Opcja /l zastępuje domyślne ustawienia określone w sekcji [Logging] pliku Setup.ini.

Opcje mogą przyjmować następujące wartości, zależnie od przechwytywanych danych:

a Powiadomienie o rozpoczęciu czynności
c Początkowe parametry interfejsu użytkownika
e Komunikaty błędów
i Tylko komunikaty informacyjne
m Komunikaty o braku pamięci
o Komunikaty o braku miejsca na dysku
p Lista tabeli właściwości w postaci właściwość=wartość
r Zapis danych czynności; zawiera informacje związane z czynnościami
u Komunikaty żądań użytkownika
v Tryb pełny, łącznie z komunikatami debugowania
w Komunikaty ostrzegawcze
* Włącz wszystkie opcje rejestrowania oprócz opcji v
+ Dołącz do istniejącego pliku dziennika

Plik dziennika oznacza nazwę i ścieżkę pliku dziennika, jaki ma być utworzony. Jeśli w nazwie pliku dziennika umieszczony zostanie znak (*), Instalator utworzy unikalną nazwę pliku dla każdego wystąpienia Instalatora.

Przykład:

/lv* "%temp%\MojaAplikacja Instalacja(*).txt"

Ten wiersz polecenia tworzy następujące pliki dziennika:

/noreboot

Po zakończeniu instalacji nie uruchamiaj ponownie komputera, ani wyświetlaj okna dialogowego z monitem o ponowne uruchomienie. Opcja /noreboot ustawia właściwość Instalatora Windows REBOOT na wartość ReallySuppress dla każdego pakietu uwzględnionego w instalacji, z wyjątkiem ostatniego.

/p [plik_msp]

Dokonaj uaktualnienia administracyjnego (plik MSP) dla instalacji klienckiej. Można również użyć opcji /p, aby dokonać uaktualnienia instalacji administracyjnej poprzez uwzględnienie opcji /a i nazwy oraz ścieżki pliku MSI punktu instalacji administracyjnej. Aby dokonać cichego uaktualnienia, należy umieścić w wierszu polecenia opcję /qb , aby wygenerować plik dziennika, należy umieścić opcję /l.

Przykłady:

msiexec /p [plik_msp] /qb /l[opcje]

msiexec /p [plik_msp] /a [plik_msi] /qb /l[opcje]

/q[opcja]

Ustaw poziomu wyświetlania interfejsu użytkownika Instalatora.

Opcje mogą przyjmować następujące wartości:

b Wyświetlaj tylko proste wskaźniki postępu i komunikaty błędów (podstawowe).
f Wyświetlaj wszystkie okna dialogowe i komunikaty; odpowiednik pominięcia opcji /q (pełne).
n Nie wyświetlaj interfejsu użytkownika; odpowiednik określenia opcji /q bez dodatkowych opcji (brak).
r Wyświetlaj wszystkie wskaźniki postępu i komunikaty błędów, bez zbierania informacji o użytkowniku (ograniczone).
- Pomiń wszystkie modalne okna dialogowe; opcja używana tylko z opcją b.
+ Dodaj komunikat zakończenia dla opcji n lub b.

Uwaga    Komunikat o zakończeniu jest wyświetlany tylko wtedy, gdy Instalator nie musi uruchamiać ponownie komputera po instalacji.

/settings plik

Określ niestandardowy plik ustawień Instalatora na użytek pliku Setup.exe, w miejsce pliku Setup.ini. Plik ustawień musi znajdować się w tym samym folderze co plik Setup.exe lub w wierszu polecenia musi być zawarta ścieżka do pliku.

Przykład:

/settings MojaAplikacja.ini

/x [plik_msi]

Usuń aplikację związaną z określonym pakietem. Pakiet musi znajdować się w tym samym folderze, co plik Setup.exe, oraz oba pliki muszą znajdować się w katalogu głównym punktu instalacji administracyjnej.

Uwaga  Należy określić ten sam pakiet, który oryginalnie był używany do instalacji aplikacji.

Przykład:

/x MójPlik.msi

właściwość=wartość

Określ wartości właściwości w wierszu polecenia. Jeśli wartość zawiera spacje, należy ująć ją w cudzysłowy ("). Aby określić dwie lub więcej par właściwość-wartość, należy oddzielić je spacjami.

ALLUSERS=[ciąg]

Zainstaluj aplikację dla wszystkich użytkowników komputera lub tylko dla bieżącego użytkownika. Domyślnie Instalator Windows instaluje aplikację dla wszystkich użytkowników komputera. Ustawienie wartości zerowej ("") dla właściwości ALLUSERS zastępuje domyślne zachowanie i instaluje aplikację dla użytkownika.

1 = Zainstaluj dla wszystkich użytkowników komputera; wymaga uprawnień administracyjnych.

2 = Zainstaluj dla wszystkich użytkowników komputera.

"" = Zainstaluj tylko dla użytkownika, który uruchomił Instalator.

ALLUSER=""

CDCACHE=[ciąg]

Określ poziom wykorzystania pamięci podręcznej.

Auto = pamięć podręczna używana w oparciu o dostępne miejsce na dysku

1 = używaj pamięci podręcznej tylko dla instalowanych elementów

2 = używaj pamięci podręcznej dla całego źródła

0 = pamięć podręczna wyłączona

CDCACHE=auto

COMPANYNAME=[ciąg]

Określ nazwę organizacji.

COMPANYNAME=Moja firma

INSTALLLOCATION=[ciąg]

Określ lokalizację instalacji.

INSTALLLOCATION=C:\Program Files\MojaAplikacja

LOCALCACHEDRIVE=[ciąg]

Określ dysk, na którym umieszczona zostanie pamięć podręczna plików.

LOCALCACHEDRIVE=C

PIDKEY=[ciąg]

Wprowadź 25-znakowy klucz licencji grupowej w wierszu polecenia Instalatora lub w pliku ustawień Instalatora. Jeśli ustawiona zostanie właściwość PIDKEY, użytkownicy nie będą musieli wprowadzać klucza produktu podczas instalacji.

PIDKEY=123467890123456789012345

TRANSFORMS=[ciąg]

Określ transformację, jakiej ma być poddana instalacja.

TRANSFORMS=\\serwer\udział\mojaAplikacja\Niestandardowa.mst

USERNAME=[ciąg]

Określ domyślną nazwę użytkownika.

USERNAME=Jan Kowalski