Install-Assembly

PackageDeployment Modul Hilfe	Package Deployment Module
Install-Assembly Cmdlet	Version 4.0.0.5

Install-Assembly

Übersicht

.NET-Assembly installieren

Syntax

Install-Assembly [-SourceFile] <String> [[-TargetFile] <String>] [[-InstallerClassParameterList] <String>] [-BreakLock] [-ContinueOnError] [-CreateBackup] [-ExecuteInstallerClass] [-InstallIntoGAC] [-UninstallCurrentVersions] [[-Replace] <String>] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Installiert ein .NET-Assembly in ein Zielverzeichnis oder in den Global Assembly Cache (GAC). Dazu muss eine entsprechende Installationsdatei ausgewählt werden (exe oder dll). Wenn nicht in den GAC installiert wird, muss das Zielverzeichnis ebenfalls angegeben werden.
InstallAssembly stellt automatisch die benötigte .NET Framework-Version des Assemblys fest und prüft bei der Installation, ob diese Version auf dem gemanagten Computer vorhanden ist. Wenn die benötigte Version nicht vorhanden ist, wird der Befehl nicht ausgeführt!
Die Ausführung von InstallAssembly ist an das .NET Framework-Tool InstallUtil.exe angelehnt.

Parameter

-BreakLock <SwitchParameter>

Dateisperre brechen, wenn die Datei vom Server-Dienst gesperrt ist bewirkt, dass vom Server-Dienst gesperrte Dateien auf einem Computer während des laufenden Windows-Betriebs aktualisiert werden können, ohne einen Neustart auszulösen. Die Ausführung dieser Option gilt jeweils für das gewählte Paket und kann in der Konfigurations-Tabelle Allgemeine Paketeigenschaften > Einstellung der Dateisperre des Server-Dienstes gesetzt werden.
Beachten Sie bei der Verwendung dieser Option, dass das Brechen der Dateisperre einen Programmabsturz der aktiven Server-Anwendung auf dem gemanagten Computer auslösen kann.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-Context <String>

User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer.
UserPerService: Benutzerbezogener Befehl, Ausführung im Service-Kontext
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
ComputerPerService: Ausführung im Service-Kontext; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.

Erforderlich	Nein
Position	4
Pipeline-Eingaben akzeptieren	Nein

-ContinueOnError <SwitchParameter>

Setzt das Skript trotz eines aufgetretenen Fehlers im betreffenden Befehl fort

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-CreateBackup <SwitchParameter>

Anlegen von Sicherungskopien der Dateien, die durch einen Kopiervorgang aktualisiert werden.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-ExecuteInstallerClass <SwitchParameter>

Wenn die Installation des .NET-Assemblys mit bestimmten Parametern ausgeführt werden soll, müssen diese hier angegeben werden.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-InstallerClassParameterList <String>

Wenn die Installation des .NET-Assemblys mit bestimmten Parametern ausgeführt werden soll, müssen diese hier angegeben werden.

Erforderlich	Nein
Position	2
Pipeline-Eingaben akzeptieren	Nein

-InstallIntoGAC <SwitchParameter>

Das Aktivieren dieser Option bewirkt, dass das ausgewählte .NET-Assembly in den GAC installiert wird. Dadurch entfallen weitere Angaben des Installationsziels.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

-Replace <String>

Always: Gleichnamige Dateien im Zielverzeichnis werden überschrieben.
Hinweis: Die Optionen "Immer überschreiben" und "Nur ältere Versionen" überschreiben bewirken zusätzlich einen sogenannten Unattended Mode. Beim Unattended Mode prüft DSM automatisch, ob sich die zu überschreibende Datei im Zugriff befindet und dadurch im laufenden Windows-Betrieb nicht installiert werden kann. Falls zutreffend, wird die entsprechende Datei in einer Liste vermerkt und ein Windows-Neustart durchgeführt. Nach dem Beenden von Windows und vor dem erneuten Start wird die Datei schließlich installiert. Durch den Befehl Unregister-SystemRestart (Automatischen Systemneustart verhindern) kann der automatische Neustart verhindert werden.
Older: Mehrstufiges Verfahren zum Versionsvergleich bei bestehenden Dateien. Zuerst werden, sofern gepflegt, die internen Versionen der Dateien verglichen. Sind die internen Versionen nicht gepflegt, erfolgt der Vergleich des Datums und der Uhrzeit der beiden gleichnamigen Dateien. Nur wenn die zu installierende Datei neuer ist, wird die bestehende Datei überschrieben.
Hinweis: Die Optionen "Immer überschreiben" und "Nur ältere Versionen" überschreiben bewirken zusätzlich einen sogenannten Unattended Mode. Beim Unattended Mode prüft DSM automatisch, ob sich die zu überschreibende Datei im Zugriff befindet und dadurch im laufenden Windows-Betrieb nicht installiert werden kann. Falls zutreffend, wird die entsprechende Datei in einer Liste vermerkt und ein Windows-Neustart durchgeführt. Nach dem Beenden von Windows und vor dem erneuten Start wird die Datei schließlich installiert. Durch den Befehl Unregister-SystemRestart (Automatischen Systemneustart verhindern) kann der automatische Neustart verhindert werden.
Never: Gleichnamige Dateien im Zielverzeichnis werden nicht überschrieben.
Confirm: Gleichnamige Dateien im Zielverzeichnis werden nur nach Bestätigung des Benutzers überschrieben.

Erforderlich	Nein
Position	3
Pipeline-Eingaben akzeptieren	Nein

-SourceFile <String>

Quelldatei.

Erforderlich	Ja
Position	0
Pipeline-Eingaben akzeptieren	Nein

-TargetFile <String>

Zieldatei.

Erforderlich	Nein
Position	1
Pipeline-Eingaben akzeptieren	Nein

-UninstallCurrentVersions <SwitchParameter>

Mithilfe dieser zusätzlichen Option werden vorhandene Versionen des ausgewählten .NET-Assemblys im GAC deinstalliert. Anschließend ist nur noch die neu installierte Version verfügbar.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

Weitere Informationen zu 'common parameters' finden Sie mit dem Kommando "Get-Help about_CommonParameters".