PackageDeployment Modul Hilfe

Package Deployment Module

Install-FileList Cmdlet

Version 4.0.0.5

Install-FileList

Übersicht

Liste von Dateien installieren

Syntax

Install-FileList [-FileList] <String[]> [-TargetDir] <String> [[-Replace] <String>] [-AbortIfLocked] [-BreakLock] [-ContinueOnError] [-CreateBackup] [-Wow64] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Installiert eine Liste von Quelldateien in einen gemeinsamen Zielpfad. Als Parameter werden die Quelldateien sowie der gemeinsame Zielpfad eingegeben.
Für den Fall, dass bei der Ausführung dieses Befehls ein Fehler auftritt, können Sie im Skript-Editor die Ausführungsoption Skript bei Fehler beenden setzen. Im Fehlerfall wird dann die Ausführung des Skripts beendet, mögliche Folgefehler werden somit vermieden, und die zugehörige Policy wird als nicht compliant angezeigt.
Dasselbe Verhalten gilt auch ohne sichtbare Ausführungsoption, wenn die Paket-Eigenschaft Fehlerbehandlung auf Skript bei Fehler immer beenden gesetzt ist (Vorgabe für neue Pakete).

Parameter

-AbortIfLocked <SwitchParameter>

Ausführung abbrechen, falls Datei gesperrt ist bewirkt, dass die Ausführung des Skripts beendet wird, wenn eine zu aktualisierende Datei gesperrt ist. Ist die Option nicht aktiviert, versucht DSM die gesperrte Datei nach einem Neustart des Computers zu aktualisieren wie oben beschrieben.
Diese Option beendet das Skript ausschließlich dann, wenn eine Dateisperre vorliegt. Für alle anderen Fehlerfälle kann ein Abbrechen des Skripts erreicht werden, indem Skript bei Fehler beenden verwendet wird (siehe oben).

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

-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

3

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

-FileList <String[]>

Die zu installierenden Quelldateien werden in Form einer Liste angegeben. Platzhalter (? *) und Variablen können verwendet werden.

Erforderlich

Ja

Position

0

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

2

Pipeline-Eingaben akzeptieren

Nein

-TargetDir <String>

Die festgelegten Quelldateien werden in den gemeinsamen Zielpfad installiert. Eine Installation in Unterverzeichnisse ist dabei nicht möglich.

Erforderlich

Ja

Position

1

Pipeline-Eingaben akzeptieren

Nein

-Wow64 <SwitchParameter>

Standardmäßig geht das PackageDeployment-Modul davon aus, auf 64-Bit Systemen in einem 64-Bit PowerShell-Prozess ausgeführt zu werden und greift daher bei Datei- und Registryzugriffen standardmäßig den Ablageort für 64-Bit Anwendungen (sofern dieser sich von dem für 32-Bit Anwendungen unterscheidet) zurück. Soll auf die 32-Bit Pendants (im Dateisystem %WinDir%\SysWOW64 statt %WinDir%\System32, in der Registry HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node statt HKEY_LOCAL_MACHINE\SOFTWARE) zugegriffen werden, verwenden Sie den -Wow64 Switch.

Erforderlich

Nein

Position

Named

Pipeline-Eingaben akzeptieren

Nein

<CommonParameters>

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