Rename-FtpFile #

ÜBERSICHT #

Bennennt eine Datei auf einem FTP- oder FTPS-Server um oder verschiebt sie in ein anderes Verzeichnis.

SYNTAX #

Rename-FtpFile [-Server] <string> [[-Protocol] <string>] [[-Port] <int>] [-ActiveMode] [-User]
    <string> [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-RemoteFile] <string> [[-NewFolder] <string>] [[-NewFile] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion verbindet sich mit einem FTP- oder FTPS-Server und führt eine Umbenennung oder Verschiebung einer Datei durch. Unterstützt aktiven oder passiven Modus sowie FTP und FTPS (explizit, TLS/SSL). Authentifizierung kann über SecureString, Klartext oder Passwortdatei erfolgen.

Der Zielname (NewFile) und Zielordner (NewFolder) können beide angegeben werden. Wird nur einer angegeben, bleibt der andere unverändert. Ist das Zielverzeichnis nicht vorhanden, wird es automatisch angelegt.

PARAMETER #

-Server #

Type: string

Hostname oder IP-Adresse des FTP-Servers.

-Protocol #

Type: string
Default: 'ftp'

Gibt das Protokoll an (ftp oder ftps). Standard: ftp.

-Port #

Type: int
Default: 21

Portnummer des Servers. Standard: 21.

-ActiveMode #

Type: switch

Wenn gesetzt, wird der aktive FTP-Modus verwendet. Standard ist passiv.

-User #

Type: string

Benutzername zur Anmeldung.

-Password #

Type: securestring

Passwort als SecureString.

-PlainPassword #

Type: string

Passwort im Klartext. Wird intern in SecureString konvertiert.

-PasswordPath #

Type: string

Pfad zu einer Datei, die das Passwort enthält (Text oder XML via Export-Clixml).

-RemoteFolder #

Type: string

Quellverzeichnis der Datei auf dem Server, z. B. /upload.

-RemoteFile #

Type: string

Name der bestehenden Datei, die umbenannt oder verschoben werden soll.

-NewFolder #

Type: string

Zielverzeichnis (optional). Wird automatisch erstellt, falls nicht vorhanden.

-NewFile #

Type: string

Neuer Dateiname (optional). Wenn leer, bleibt der Dateiname gleich.

AUSGABEN #

bool

Gibt $true zurück, wenn das Umbenennen erfolgreich war, sonst $false.

BEISPIELE #

# Datei im selben Verzeichnis umbenennen
Rename-FtpFile -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' `
               -RemoteFolder '/upload' -RemoteFile 'data.old' -NewFile 'data.new'

# Datei in ein anderes Verzeichnis verschieben
Rename-FtpFile -Server 'ftp.example.com' -Protocol 'ftps' -ActiveMode `
               -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' `
               -RemoteFolder '/inbound' -RemoteFile 'order.txt' -NewFolder '/archive' -Verbose

HINWEISE #

Unterstützt FTP und FTPS (explizit, TLS/SSL)
Kompatibel mit PowerShell 5.1 und 7+