Remove-SftpFile #

ÜBERSICHT #

Löscht eine Datei von einem SFTP-Server.

SYNTAX #

Remove-SftpFile [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-RemoteFile] <string> [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion verbindet sich per SFTP mit einem Server und löscht die angegebene Datei. Unterstützt werden unterschiedliche Methoden zur Authentifizierung wie Klartext-Passwort, SecureString, Passwort-Datei und Zertifikat.

Existiert die angegebene Datei auf dem Server nicht, gibt die Funktion False zurück und erzeugt eine Warnung.

Nutzt intern das Modul POSH-SS

PARAMETER #

-Server #

Type: string

Hostname oder IP des SFTP-Servers.

-Port #

Type: int
Default: 22

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

-User #

Type: string

Benutzername zur Anmeldung am Server.

-Password #

Type: securestring

Passwort als SecureString (ParameterSet ‘secure’).

-PlainPassword #

Type: string

Klartext-Passwort (ParameterSet ‘plain’). Wird intern zu SecureString konvertiert.

-PasswordPath #

Type: string

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

-Certificate #

Type: string

Pfad zu privater Schlüsseldatei (*.ppk, *.pem) für Zertifikats-Authentifizierung.

-RemoteFolder #

Type: string
Default: ""

Ordnerpfad auf dem SFTP-Server. Wird der Parameter nicht angegeben, erfolgt das Löschen der Datei aus dem Benutzer-Home-Verzeichnis.

-RemoteFile #

Type: string

Name der Datei, die gelöscht werden soll.

AUSGABEN #

bool

True bei Erfolg, False bei Fehler.

BEISPIELE #

# Löscht 'test.txt' im Stammverzeichnis.
Remove-SftpFile -Server 'sftp.example.com' -User 'root' -PlainPassword 'secret' -RemoteFile 'test.txt'

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.