TRANSFORMS-Eigenschaft

Die TRANSFORMS-Eigenschaft ist eine Liste der Transformationen, die das Installationsprogramm beim Installieren 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 anhand ihres Dateinamens oder vollständigen Pfads angegeben werden. Um mehrere Transformationen anzugeben, trennen Sie jeden Dateinamen oder vollständigen Pfad durch ein Semikolon (;). Um beispielsweise drei Transformationen auf ein Paket anzuwenden, legen Sie TRANSFORMS auf eine Liste von Dateinamen oder auf eine Liste mit vollständigen Pfaden 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 einen Speicher der .msi Datei eingebettet ist, anstatt als eigenständige Datei, indem Sie dem Dateinamen einen Doppelpunkt (:) voranstellen. Im folgenden Beispiel wird beispielsweise angegeben, dass transform1.mst und transform2.mst in die datei .msi eingebettet sind und dass transform3.mst eine eigenständige Datei ist.

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

Das Installationsprogramm erfordert die in TRANSFORMS aufgeführten Transformationen bei jeder Installation, Ankündigung, Installation bei Bedarf oder Wartungsinstallation des Pakets. Die Richtlinie TransformsSecure, die TRANSFORMS-Eigenschaft und das erste Zeichen der TRANSFORMS-Zeichenfolge informieren das Installationsprogramm darüber, wie die Quellresilienz eigenständiger Transformationsdateien behandelt werden kann. Windows Das Installationsprogramm behandelt das Festlegen der TransformsAtSource-Richtlinie oder TRANSFORMSATSOURCE genauso wie die TransformsSecure-Richtlinie und TRANSFORMSSECURE. Beachten Sie, dass in die .msi Datei eingebettete Transformationen nicht zwischengespeichert werden und immer aus dem Paket abgerufen werden.

TRANSFORMS-Eigenschaft Transforms Secure Zwischenspeicherung und Resilienz
@[liste der Dateinamen] Beispiel:
@transform1.mst;transform2.mst; transform3.mst
Keine Auswirkung. Secure-At-Source-Transformationen. Die Quelle der Transformationen muss sich im Stammverzeichnis der Quelle für das Paket enthalten. Wenn das Paket installiert oder angekündigt wird, speichert das Installationsprogramm die Transformationen auf dem Computer des Benutzers in einem Cache, in dem 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 entspricht der Suche in der Quellliste nach einer .msi-Datei. Weitere Informationen finden Sie unter Quellresilienz.
[Liste der Pfade] Beispiel:
\server\share\path\transform1.mst; \ server2\share2\path2\transform2.mst Keine Auswirkung. Secure-Full-Path transformiert. Die Quelle jeder Transformation muss sich am 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, in dem 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 auf 1 ODER festgelegt
TransformsAtSource-Richtlinie oder TRANSFORMSATSOURCE auf 1 festgelegt.
Wenn TRANSFORMS eine Liste von Dateinamen ist, behandelt das Installationsprogramm diese als Secure-At-Source-Transformationen. Wenn TRANSFORMS eine Liste mit vollständigen Pfaden ist, 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 auf AND festgelegt.
TransformsAtSource-Richtlinie und TRANSFORMSATSOURCE sind nicht festgelegt.
Ungesicherte Transformationen. Die Quelle der Transformationen muss sich im Stammverzeichnis der Quelle für das Paket enthalten. Wenn das Paket installiert oder pro Benutzer angekündigt wird, speichert das Installationsprogramm die Transformationen im Profil des Benutzers. Dadurch kann ein Benutzer zwischen Computern roaming, während seine Anpassungen beibehalten werden. Bei einer Computerinstallation 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 entspricht der Suche in der Quellliste nach einer .msi-Datei. Weitere Informationen finden Sie unter Quellresilienz.
[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 auf AND festgelegt.
TransformsAtSource-Richtlinie und TRANSFORMSSECURE sind nicht festgelegt.
Ungesicherte Transformationen. Wenn das Paket installiert oder pro Benutzer angekündigt wird, speichert das Installationsprogramm die Transformationen im Profil des Benutzers. Dadurch kann ein Benutzer zwischen Computern roaming, während seine Anpassungen beibehalten werden. Bei einer Computerinstallation 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 entspricht der Suche in der Quellliste nach einer .msi-Datei. Weitere Informationen finden Sie unter Quellresilienz.

Sie können Dateinamen und Pfade nicht zusammen in derselben TRANSFORMS-Liste verwenden. Sie können keine sicheren Und Profiltransformationen zusammen in derselben Liste angeben. Sie können Transformationen, die in das Paket eingebettet sind, in eine Liste mit anderen Transformationen einschließen.

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

Beachten Sie, dass Semikolons nicht in einem Transformationsdateinamen oder -pfad verwendet werden dürfen, da das Listentrennzeichen für Transformationen das Semikolon ist.

Bemerkungen

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

Beachten Sie, dass das Installationsprogramm eine andere Suchreihenfolge für unsichere Transformationen verwendet, die bei der ersten Installation und bei Wartungsinstallationen angewendet werden. Weitere Informationen finden Sie unter Unsecured Transforms.

Requirements (Anforderungen)

Anforderung Wert
Version
Windows Installationsprogramm 5.0 auf Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 auf Windows Server 2008 oder Windows Vista. Windows Installationsprogramm auf Windows Server 2003 oder Windows XP. Informationen zu den mindestens erforderlichen Windows Service Packs, die für eine Windows Installer-Version erforderlich sind, finden Sie unter Windows Installer Run-Time Requirements ( Anforderungen für Windows Installer).

Siehe auch

Eigenschaften

Datenbanktransformationen

Zusammenführungen und Transformationen

Quellresilienz