Rename-FtpFolder

ÜBERSICHT

Bennent ein Verzeichnis auf einem FTP- oder FTPS-Server um.

SYNTAX

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

BESCHREIBUNG

Diese Funktion verbindet sich mit einem FTP- oder FTPS-Server und benennt ein angegebenes Remote-Verzeichnis um. Sie unterstützt aktiven oder passiven Modus sowie FTP und FTPS (explizit, TLS/SSL). Die Authentifizierung kann über SecureString, Klartext oder Passwortdatei erfolgen.

Der alte und der neue Ordnerpfad werden getrennt angegeben. Beide Pfade müssen absolute Serverpfade sein, z. B. `/inbox` und `/inbox-old`.

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

Der bestehende Ordner, der umbenannt werden soll. Beispiel: `/inbox`.

-NewFolder

Type: string

Neuer Name bzw. Zielpfad des Verzeichnisses. Beispiel: `/inbox-old`.

AUSGABEN

bool

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

BEISPIELE

# Benennt den Ordner '/inbox' in '/inbox-archive' um
Rename-FtpFolder -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' `
                 -RemoteFolder '/inbox' -NewFolder '/inbox-archive'

# FTPS mit Passwortdatei und aktivem Modus
Rename-FtpFolder -Server 'ftp.example.com' -Protocol 'ftps' -ActiveMode `
                 -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' `
                 -RemoteFolder '/data/old' -NewFolder '/data/archive' -Verbose

HINWEISE

Unterstützt FTP und FTPS (explizit, TLS/SSL)
Kompatibel mit PowerShell 5.1 und 7+
Kann nur leere oder direkt benennbare Verzeichnisse umbenennen

Rename-FtpFolder