Copy-File

PackageDeployment Modul Hilfe	Package Deployment Module (DSM eScript Commands)
Copy-File Cmdlet	Version 1.0.0.3

Copy-File

Übersicht

Dateien kopieren

Syntax

Copy-File [-File] <String> [-TargetDir] <String> [[-Replace] <String>] [-ContinueOnError] [-CreateBackup] [-Recurse] [-Wow64] [[-Context] <String>] [<CommonParameters>]

Beschreibung

Kopieren von einer oder mehreren Dateien in ein Zielverzeichnis. Die Arbeitsweise sowie die verwendbare Syntax folgt dem internen DOS-Befehl COPY (Verwendung von Platzhaltern und Umgebungsvariablen). Zusätzlich können Variablen wie windir, winsysdir, usw. verwendet werden.

Parameter

-Context <String>

User: Ausführung unter Benutzerkonto; Protokollierung in HKEY_CURRENT_USER, also für den Benutzer.
UserPerService: Benutzerbezogener Befehl, Ausführung mit DSM Runtime Service
Computer: Ausführung unter Benutzerkonto; Protokollierung in HKEY_LOCAL_MACHINE, also für den Computer.
Computer: Ausführung mit DSM Runtime Service; 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

-File <String>

Die zu installierende Quelldatei. Platzhalter (? *) und Variablen können verwendet werden.

Erforderlich	Ja
Position	0
Pipeline-Eingaben akzeptieren	Nein

-Recurse <SwitchParameter>

Diese Option wird nur bei Ausführung unter 32 Bit (Win9X, WinNT4.x, NT-Service, Windows 2000/XP) berücksichtigt. Beachten Sie bei der Verwendung dieses Befehls mit dem DSM Runtime Service die Hinweise zum DSM Runtime Service.

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	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>

Aus Kompatibilitätsgründen verwendet Ivanti DSM bei Datei- und Registryzugriffen standardmäßig den Ablageort für 32-Bit Anwendungen (sofern dieser sich von dem für 64-Bit Anwendungen unterscheidet). Bei Dateizugriffen hat dies zur Folge, dass bei x64-Systemen auf das %WinDir%\SysWOW64 Verzeichnis und nicht auf das %WinDir%\system32 Verzeichnis zugegriffen wird. Bei Registry-Befehlen werden (unter anderem) Zugriffe auf HKEY_LOCAL_MACHINE\SOFTWARE nach HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node umgeleitet. Der x64-Schalter bewirkt, dass bei der Ausführung des Skript-Befehls auf einem x64-Computer diese Umleitung von Datei- bzw Registryzugriffen abgeschaltet und der eScript-Befehl auf angegebenen Pfad ausgeführt wird. Beim Callscript-Befehl wird damit das Skript in einem 64-Bit Prozess ausgeführt.

Erforderlich	Nein
Position	Named
Pipeline-Eingaben akzeptieren	Nein

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