Rename-SftpFolder

ÜBERSICHT

Benennt ein Verzeichnis auf einem SFTP-Server um oder verschiebt es.

SYNTAX

Rename-SftpFolder [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-NewFolder] <string> [<CommonParameters>]

BESCHREIBUNG

Benennt ein existierendes Verzeichnis auf einem SFTP-Server um oder verschiebt es an einen neuen Pfad.

Folgende Prüfungen erfolgen automatisch:

Existenzprüfung des Quellverzeichnisses
Prüfung, ob das Zielverzeichnis bereits existiert (Ziel darf noch nicht vorhanden sein)
Verzeichnisse dürfen nicht leer sein oder das Root-Verzeichnis ('/') betreffen.

Die Funktion unterstützt Authentifizierungen per Klartext-Passwort, SecureString, Passwort-Datei oder Zertifikat (Privatschlüssel).

PARAMETER

-Server

Type: string

Adresse oder Hostname des SFTP-Servers.

-Port

Type: int
Default: 22

TCP-Port des SFTP-Servers (Standard: 22).

-Certificate

Type: string

Optionaler Pfad zur Privatschlüsseldatei für zertifikatsbasierte Authentifizierung.

-User

Type: string

Benutzername zur Authentifizierung.

-Password

Type: securestring

Passwort als SecureString (ParameterSet 'secure').

-PlainPassword

Type: string

Passwort im Klartext (ParameterSet 'plain').

-PasswordPath

Type: string

Pfad zu einer Passwort-Datei (ParameterSet 'file').

-RemoteFolder

Type: string
Default: ""

Quellverzeichnis auf dem SFTP-Server, das umbenannt oder verschoben werden soll.

-NewFolder

Type: string

Zielverzeichnisname oder neuer Name. Darf noch nicht existieren.

AUSGABEN

bool

True bei erfolgreicher Ausführung, andernfalls False.

BEISPIELE

# Verzeichnis '/alt' nach '/neu' umbenennen
Rename-SftpFolder -Server "sftp.example.com" -User "user1" -PlainPassword "meinPasswort" `
  -RemoteFolder "/alt" -NewFolder "/neu"

# Verzeichnis '/daten' in Unterverzeichnis '/archiv/daten2025' verschieben
$secPwd = ConvertTo-SecureString "meinPasswort" -AsPlainText -Force
Rename-SftpFolder -Server "sftp.example.com" -User "user1" -Password $secPwd `
  -RemoteFolder "/daten" -NewFolder "/archiv/daten2025"

# Verzeichnis im Homeverzeichnis umbenennen (kein Slash erforderlich)
Rename-SftpFolder -Server "sftp.example.com" -User "user1" -Certificate "C:\key.pem" `
  -RemoteFolder "alteDaten" -NewFolder "neueDaten"

HINWEISE

Benötigt das Modul POSH-SSH. Installation: `Install-Module -Name POSH-SSH -Repository PSGallery`
Intern geöffnete SFTP-Sitzungen werden automatisch nach Beendigung dieser Funktion geschlossen.

Rename-SftpFolder