Get-SftpFileSize #

ÜBERSICHT #

Ermittelt die Dateigröße einer Datei auf einem SFTP-Server.

SYNTAX #

Get-SftpFileSize [-Server] <string> [[-Port] <int>] [[-Certificate] <string>] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>]
    [[-RemoteFolder] <string>] [-RemoteFile] <string>

BESCHREIBUNG #

Diese Funktion verbindet sich mit einem angegebenen SFTP-Server und gibt die Größe einer spezifischen Datei in Bytes zurück. Die Authentifizierung unterstützt sichere Passwörter, Klartextpasswörter und gespeicherte Passwörter aus Dateien. Optional kann ein privater Schlüssel (Zertifikat) zur Authentifizierung angegeben werden.

PARAMETER #

-Server #

Type: string

Der Hostname oder die IP-Adresse des SFTP-Servers.

-Port #

Type: int
Default: 22

Optionaler Port für die Verbindung zum SFTP-Server (Standard: 22).

-Certificate #

Type: string

Optionaler Pfad zu einem privaten Schlüssel (Zertifikat) für eine schlüsselbasierte Authentifizierung.

-User #

Type: string

Benutzername für die Anmeldung am SFTP-Server.

-Password #

Type: securestring

Passwort als SecureString für die Anmeldung (ParameterSet: secure).

-PlainPassword #

Type: string

Passwort in Klartext für die Anmeldung (ParameterSet: plain).

-PasswordPath #

Type: string

Pfad zu einer Datei mit dem Passwort als SecureString oder Klartext (ParameterSet: file).

-RemoteFolder #

Type: string
Default: ""

Der Ordnerpfad auf dem SFTP-Server, in dem sich die Datei befindet. Standard ist ‘/’.

-RemoteFile #

Type: string

Name der Datei auf dem SFTP-Server, deren Größe ermittelt werden soll.

AUSGABEN #

nullable[long]

Größe der Datei in Bytes, oder $null wenn die Datei nicht gefunden wird oder ein Fehler auftritt.

BEISPIELE #

# Ermittelt die Größe der Datei 'invoice.pdf' im Hauptverzeichnis des SFTP-Servers.
Get-SftpFileSize -Server 'sftp.example.com' -User 'username' -PlainPassword 'myPassword' -RemoteFile 'invoice.pdf'

# Ermittelt die Dateigröße der Datei 'report.csv' im Verzeichnis '/data', wobei das Passwort aus einer sicheren Datei geladen wird.
Get-SftpFileSize -Server 'sftp.example.com' -User 'username' -PasswordPath 'C:\Secure\pwd.xml' -RemoteFolder '/data' -RemoteFile 'report.csv'

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.