Install-Assembly

Installiert ein .NET-Assembly in ein Zielverzeichnis oder in den Global Assembly Cache (GAC). Dazu muss eine entsprechende Installationsdatei ausgewählt werden. Wenn nicht in den GAC installiert wird, muss das Zielverzeichnis ebenfalls angegeben werden.

Install-Assembly stellt automatisch die benötigte .NET Framework-Version des Assemblys fest und prüft bei der Installation, ob diese Version auf dem Computer vorhanden ist. Wenn die benötigte Version nicht vorhanden ist, wird der Befehl nicht ausgeführt.

Die Ausführung von Install-Assembly ist an das .NET Framework-Tool InstallUtil.exe angelehnt.

Hinweis: Beginnend mit Version 3.0 der PPB kann der Install-Assembly-Befehl auch durch Drag-and-Drop von DLL-Dateien (*.dll) in das Scriptfenster erzeugt werden. Sofern sich die Dateien bereits im Paketverzeichnis befinden, wird der Quellpfad relativ mit .\ referenziert, befinden sich die Quelldateien außerhalb des Paketverzeichnisses, wird der vollständige Pfad übernommen.


Befehlseingaben:

  • Quelldatei
    Gibt die zu installierende Dateien inklusive Pfad an. Dabei sind Variablen erlaubt. Wählen Sie über die "..."-Schaltfläche eine (auf dem Paketiersystem) bestehende Datei aus oder geben Sie den Pfad manuell an.
  • Assembly in den Global Assembly Cache (GAC) installieren
    Das Aktivieren dieser Option bewirkt, dass das ausgewählte .NET-Assembly in den GAC installiert wird. Dadurch entfallen weitere Angaben des Installationsziels.
    • Alle verfügbaren Versionen im GAC deinstallieren
      Wenn das Assembly in den GAC installiert werden soll, Ist diese zusätzlichen Option verfügbar. Wird sie aktiviert, werden vorhandene Versionen des ausgewählten .NET-Assemblys im GAC deinstalliert. Anschließend ist nur noch die neu installierte Version verfügbar.
  • Zieldatei
    Gibt die Zieldatei(en) inklusive Pfad an.
  • Überschreiboptionen
    • Immer überschreiben
      Dies ist die Standard-Option und legt fest, dass vorhandene gleichnamige Dateien immer überschrieben werden.
    • Nur ältere Versionen überschreiben
      Diese Option legt fest, dass vorhandene gleichnamige Dateien nur dann überschrieben werden, wenn sie älter als die zu kopierende Datei sind.
    • Nie überschreiben
      Gibt an, dass vorhandene gleichnamige Dateien nie überschrieben werden.
    • Überschreiben mit Bestätigung
      Vorhandene gleichnamige Dateien werden nur überschrieben, wenn der Benutzer dies bestätigt.
  • Dateisperre
    • Dateisperre brechen, wenn die Datei vom Server-Dienst gesperrt ist
      Wenn das bestehende Assembly aktuell in Benutzung und daher vom Server-Dienst gesperrt ist, werden bestehende Handles bei Aktivieren dieser Option aufgebrochen. Dies kann dazu führen, dass laufende Applikationen, die das Assembly verwenden, nicht mehr funktionieren.
  • Sicherungen
    • Sicherungsdateien erzeugen
      Wenn Dateien durch die Installation ersetzt werden, wird von den bestehenden Dateien eine Sicherungskopie erzeugt.
  • .Net Installer-Klasse
    • Installation mit folgenden Parametern ausführen
      Wenn die Installation des .NET-Assemblys mit bestimmten Parametern ausgeführt werden soll, müssen diese hier angegeben werden.


Beispiel:

Das folgende Beispiel installiert das Assembly unseres Produkt "PowerShell Extensions for Ivanti DSM" in den Global Assembly Cache und entfernt gleichzeitig gegebenenfalls vorhandene ältere Versionen:


Entspricht DSM eScript Befehl:

  • InstallAssembly


Siehe auch: