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

VERWANDTE LINKS

Get-FtpDir

Get-FtpFileAge

Get-FtpFileDate

Get-FtpFileSize

Get-FtpNewestFilename

Get-FtpOldestFilename

New-FtpFolder

Receive-FtpFile

Remove-FtpFile

Remove-FtpFilesOlderThan

Remove-FtpFolder

Rename-FtpFolder

Send-FtpFile

Test-FtpFile

Test-FtpFolder

HINWEISE

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