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.

VERWANDTE LINKS

Get-SftpDir

Get-SftpFileAge

Get-SftpFileDate

Get-SftpFileSize

Get-SftpOldestFilename

New-SftpFolder

Receive-SftpFile

Remove-SftpFile

Remove-SftpFolder

Rename-SftpFolder

Send-SftpFile

Test-SftpFile

Test-SftpFingerprint

Test-SftpFolder

Test-SftpPort

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.