Move-FileSafe

ÜBERSICHT

Verschiebt eine Datei zuverlässig auch bei sehr langen Pfaden (>260 Zeichen).

SYNTAX

Move-FileSafe [-Source] <string> [-DestinationDir] <string> [-OnlyIfTooLong] [-Force]
    [<CommonParameters>]

BESCHREIBUNG

Nutzt zuerst `[System.IO.File]::Move()`. Unter Windows werden lange Pfade mit Extended-Notation (`\\?\`) unterstützt, bei Bedarf greift ein Robocopy-Fallback.

Fehlerbehandlung erfolgt über PowerShells Standardmechanismus:

• Mit `-ErrorAction Stop` wird eine Exception geworfen.
• Ohne (`Continue` oder `SilentlyContinue`) gibt die Funktion stattdessen `$false` zurück.

PARAMETER

-Source

Type: string

Vollständiger Quellpfad zur Datei. Relativpfade werden automatisch absolutisiert.

-DestinationDir

Type: string

Zielordner. Wird bei Bedarf automatisch angelegt.

-OnlyIfTooLong

Type: switch

Wenn gesetzt, werden nur Pfade umgewandelt, die zu lang für das klassische Windows-Limit sind.

-Force

Type: switch

Überschreibt existierende Zieldateien. Ohne diesen Schalter wird beim Vorhandensein einer Datei im Ziel ein Fehler erzeugt.

AUSGABEN

Boolean

`$true` bei Erfolg, `$false` bei Fehler (außer wenn `-ErrorAction Stop` gesetzt ist).

BEISPIELE

# Standard: gibt true/false zurück
Move-FileSafe -Source 'C:\in\a.txt' -DestinationDir 'C:\out'

# Erzwingt Exception bei Fehler
Move-FileSafe -Source 'C:\in\a.txt' -DestinationDir 'C:\out' -ErrorAction Stop