TRANSFORMS-Eigenschaft

Die TRANSFORMS-Eigenschaft ist eine Liste der Transformationen, die das Installationsprogramm bei der Installation des Pakets anwendet. Das Installationsprogramm wendet die Transformationen in der gleichen Reihenfolge an, in der sie in der Eigenschaft aufgeführt sind. Transformationen können durch ihren Dateinamen oder den vollständigen Pfad angegeben werden. Um mehrere Transformationen anzugeben, trennen Sie jeden Dateinamen oder vollständigen Pfad durch ein Semikolon (;). Wenn Sie beispielsweise drei Transformationen auf ein Paket anwenden möchten, legen Sie TRANSFORMS auf eine Liste von Dateinamen oder auf eine Liste vollständiger Pfade fest.

TRANSFORMS=transform1.mst;transform2.mst;transform3.mst
TRANSFORMS=\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst;\\server3\share3\path3\transform3.mst

Sie können angeben, dass eine Transformationsdatei in eine Speicherung der MSI-Datei und nicht als eigenständige Datei eingebettet ist, indem Sie dem Dateinamen einen Doppelpunkt (:) voranstellen. Das folgende Beispiel zeigt z. B., dass transform1.mst und transform2.mst in die MSI-Datei eingebettet sind und dass transform3.mst eine eigenständige Datei ist.

TRANSFORMS=:transform1.mst;:transform2.mst;transform3.mst

Das Installationsprogramm benötigt die in TRANSFORMS aufgeführten Transformationen bei jeder Installation, Ankündigung, bedarfsabhängigen Installation oder Wartungsinstallation des Pakets. Die TransformsSecure-Richtlinie, die TRANSFORMS-Eigenschaft und das erste Zeichen der Zeichenfolge TRANSFORMS teilen dem Installationsprogramm mit, wie es die Quellenresilienz eigenständiger Transformationsdateien behandeln soll. Windows Installer behandelt das Festlegen der TransformsAtSource-Richtlinie oder von TRANSFORMSATSOURCE genauso wie bei der TransformsSecure-Richtlinie und bei TRANSFORMSSECURE. Beachten Sie, dass die in der MSI-Datei eingebetteten Transformationen nicht zwischengespeichert und immer aus dem Paket abgerufen werden.

TRANSFORMS-Eigenschaft Sichere Transformation Zwischenspeicherung und Resilienz
@[Liste von Dateinamen] Beispiel:
@transform1.mst;transform2.mst; transform3.mst
Keine Auswirkung. Secure-At-Source-Transformationen. Die Quelle der Transformationen muss sich am Stamm der Quelle für das Paket befinden. Wenn das Paket installiert oder angekündigt wird, speichert das Installationsprogramm die Transformationen auf dem Computer des Benutzers in einem Cache, für den der Benutzer keinen Schreibzugriff hat. Wenn die lokale Kopie der Transformation nicht mehr verfügbar ist, sucht das Installationsprogramm nach einer Quelle, um den Cache wiederherzustellen. Die Methode ist identisch mit dem Durchsuchen der Quellliste nach einer MSI-Datei. Siehe Quellenresilienz.
[Liste der Pfade] Beispiel:
\|\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst
Keine Auswirkung. Secure-Full-Path-Transformationen. Die Quelle jeder Transformation muss sich im vollständigen Pfad befinden, der an TRANSFORMS übergeben wird. Die Transformationsquelle muss sich nicht an der Quelle des Pakets befinden. Wenn das Paket installiert oder angekündigt wird, speichert das Installationsprogramm die Transformationen auf dem Computer des Benutzers in einem Cache, für den der Benutzer keinen Schreibzugriff hat. Wenn die lokale Kopie der Transformation nicht mehr verfügbar ist, kann das Installationsprogramm den Cache nur aus der Quelle unter dem angegebenen Pfad wiederherstellen.
[Liste der Dateinamen] Das erste Zeichen ist nicht @ oder |.
Beispiel:
transform1.mst;transform2.mst;transform3.mst
TransformsSecure-Richtlinie oder TRANSFORMSSECURE ist auf 1 festgelegt ODER
TransformsAtSource-Richtlinie oder TRANSFORMSATSOURCE ist auf 1 festgelegt.
Wenn TRANSFORMS eine Liste von Dateinamen darstellt, behandelt das Installationsprogramm diese als Secure-At-Source-Transformationen. Wenn TRANSFORMS einer Liste von vollständigen Pfaden entspricht, behandelt das Installationsprogramm diese als Secure-Full-Path-Transformationen.
[Liste der Dateinamen] Das erste Zeichen ist nicht @ oder |.
Beispiel:
transform1.mst;transform2.mst;transform3.mst
TransformsSecure-Richtlinie und TRANSFORMSSECURE sind nicht festgelegt UND
TransformsAtSource-Richtlinie und TRANSFORMSATSOURCE sind nicht festgelegt.
Ungesicherte Transformationen. Die Quelle der Transformationen muss sich am Stamm der Quelle für das Paket befinden. Wenn das Paket pro Benutzer installiert oder angekündigt wird, speichert das Installationsprogramm die Transformationen im Profil des Benutzers. Dies ermöglicht es einem Benutzer, zwischen Computern zu wechseln, während seine Anpassungen beibehalten werden. Bei einer Installation pro Computer wird die Transformation im Ordner „%windir%\Installer“ gespeichert. Wenn die lokale Kopie der Transformation nicht mehr verfügbar ist, sucht das Installationsprogramm nach einer Quelle, um den Cache wiederherzustellen. Die Methode ist identisch mit dem Durchsuchen der Quellliste nach einer MSI-Datei. Siehe Quellenresilienz.
[Liste der Pfade] Das erste Zeichen ist nicht @ oder |.
Beispiel:
\\server\share\path\transform1.mst;\\server2\share2\path2\transform2.mst
TransformsAtSource-Richtlinie und TRANSFORMSSECURE sind nicht festgelegt UND
TransformsAtSource-Richtlinie und TRANSFORMSSECURE sind nicht festgelegt.
Ungesicherte Transformationen. Wenn das Paket pro Benutzer installiert oder angekündigt wird, speichert das Installationsprogramm die Transformationen im Profil des Benutzers. Dies ermöglicht es einem Benutzer, zwischen Computern zu wechseln, während seine Anpassungen beibehalten werden. Bei einer Installation pro Computer wird die Transformation im Ordner „%windir%\Installer“ gespeichert. Wenn die lokale Kopie der Transformation nicht mehr verfügbar ist, sucht das Installationsprogramm nach einer Quelle, um den Cache wiederherzustellen. Die Methode ist identisch mit dem Durchsuchen der Quellliste nach einer MSI-Datei. Siehe Quellenresilienz.

 

Sie können Dateinamen und Pfade nicht zusammen in der gleichen TRANSFORMS-Liste verwenden. Sie können keine Sicherheits- und Profiltransformationen in derselben Liste angeben. Sie können im Paket eingebettete Transformationen in eine Liste mit anderen Transformationen einschließen.

@transform1.mst;:transform2.mst 
|\\server\share\path\transform1.mst;:transform2.mst

Beachten Sie, dass das Listentrennzeichen für Transformationen das Semikolon ist und daher keine Semikolons in einem Dateinamen oder Pfad für eine Transformation verwendet werden dürfen.

Bemerkungen

In den Fällen, in denen die TransformsSecure-Richtlinie oder die TRANSFORMSSECURE-Eigenschaft mit dem Windows Installer festgelegt wurde, ist es nicht erforderlich, das Symbol @ oder | zu übergeben, wenn Sie TRANSFORMS über die Befehlszeile festlegen. Das Installationsprogramm geht von „Secure-At-Source“ oder „Secure-Full-Path“ aus, wenn die Liste ausschließlich aus Dateinamen besteht, die sich in der Quelle befinden oder aus vollständigen Pfaden bestehen. Sie können die beiden Arten von Transformationsquellen immer noch nicht kombinieren.

Beachten Sie, dass das Installationsprogramm eine andere Suchreihenfolge für ungesicherte Transformationen verwendet, die bei Erst- und Wartungsinstallationen angewendet werden. Weitere Informationen finden Sie unter Ungesicherte Transformationen.

Anforderungen

Anforderung Wert
Version
Windows Installer 5.0 unter Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 unter Windows Server 2008 oder Windows Vista. Windows Installer unter Windows Server 2003 oder Windows XP. Informationen zum mindestens erforderlichen Windows Service Pack für eine Windows Installer-Version finden Sie unter Windows Installer – Laufzeitanforderungen.

Siehe auch

Eigenschaften

Datenbanktransformationen

Merges und Transformationen

Quellenresilienz