Rename Sftp File X
Zuletzt geändert: 14.03.2026 05:56

Rename-SftpFileX #

ÜBERSICHT #

Benennt eine Datei auf einem SFTP-Server um oder verschiebt sie in ein anderes Verzeichnis.

SYNTAX #

Rename-SftpFileX [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-RemoteFile] <string> [[-NewFolder] <string>] [[-NewFile] <string>]
    [-Force] [<CommonParameters>]

BESCHREIBUNG #

Die Funktion ermöglicht es, eine Datei auf einem SFTP-Server umzubenennen oder in ein anderes Zielverzeichnis zu verschieben.

Folgende Schritte werden automatisch ausgeführt:

  • Prüfung der Existenz der Quelldatei
  • Erstellung des Zielverzeichnisses bei Bedarf (rekursiv)
  • Optionales Überschreiben einer vorhandenen Zieldatei (-Force)
  • Verschieben bzw. Umbenennen der Datei

Unterstützt werden Authentifizierungen über 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

Pfad zur Privatschlüsseldatei für zertifikatsbasierte Authentifizierung.

-User #

Type: string

Benutzername zur Authentifizierung.

-Password #

Type: securestring

Passwort als SecureString.

-PlainPassword #

Type: string

Passwort im Klartext, intern zu SecureString umgewandelt.

-PasswordPath #

Type: string

Pfad zu einer Passwort-Datei (ParameterSet ‘file’).

-RemoteFolder #

Type: string
Default: ""

Quellverzeichnis auf dem SFTP-Server. Bei Nichtangabe wird das Home-Verzeichnis verwendet.

-RemoteFile #

Type: string

Name der Quelldatei, die umbenannt oder verschoben werden soll.

-NewFolder #

Type: string

Optionales Zielverzeichnis. Wird automatisch rekursiv erstellt, falls nicht vorhanden. Wenn nicht angegeben, bleibt die Datei im ursprünglichen Verzeichnis.

-NewFile #

Type: string

Optional neuer Name der Zieldatei. Wenn nicht angegeben, wird der ursprüngliche Dateiname verwendet.

-Force #

Type: switch

Erzwingt das Überschreiben der Zieldatei, falls diese bereits existiert.

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.