Get-FtpDir

EulandaXtools — Funktionsreferenz

Get-FtpDir

ÜBERSICHT

Listet Dateien oder Verzeichnisse von einem FTP- oder FTPS-Server auf.

SYNTAX

Get-FtpDir [-Server] <string> [[-Protocol] <string>] [[-Port] <int>] [-ActiveMode] [-User] <string>
    [[-Password] <securestring>] [[-PlainPassword] <string>] [[-PasswordPath] <string>] [[-DirType]
    <string>] [[-Mask] <string>] [[-RemoteFolder] <string>] [<CommonParameters>]

BESCHREIBUNG

Diese Funktion stellt eine Verbindung zu einem FTP- oder FTPS-Server her und gibt eine sortierte Liste von Dateien oder Verzeichnissen im angegebenen Remote-Verzeichnis zurück. Unterstützt sowohl passiven als auch aktiven Modus, Klartext- oder SecureString-Passwort, sowie den Passwortbezug aus einer Datei (z. B. `C:\Users\\.eulandaconnect\password.xml`).

Die Ausgabe ist ein Array von Dateinamen oder Verzeichnisnamen, optional gefiltert über einen Wildcard-Maskenfilter (z. B. `*.txt`, `backup*`).

PARAMETER

-Server

Type: string

Hostname oder IP-Adresse des FTP-Servers.

-Protocol

Type: string
Default: 'ftp'

Gibt das Protokoll an (`ftp` oder `ftps`). Standard: `ftp`.

-Port

Type: int
Default: 21

Port des Servers. Standard: `21`.

-ActiveMode

Type: switch

Wenn gesetzt, wird der aktive FTP-Modus verwendet. Standard: passiv.

-User

Type: string

Benutzername zur Anmeldung.

-Password

Type: securestring

Passwort als SecureString, zur Authentifizierung.

-PlainPassword

Type: string

Passwort im Klartext. Wird automatisch in einen SecureString konvertiert.

-PasswordPath

Type: string

Pfad zu einer Datei, die das Passwort enthält. Unterstützt einfache Textdateien und SecureString-XML-Dateien (Export-Clixml).

-DirType

Type: string
Default: 'file'

Gibt an, ob Dateien (`file`) oder Verzeichnisse (`directory`) gelistet werden sollen. Standard ist `file`.

-Mask

Type: string
Default: '*'

Optionaler Filter mit Wildcards (z. B. `*.xml`). Standard: `*`.

-RemoteFolder

Type: string
Default: '/'

Remote-Verzeichnis auf dem FTP-Server, z. B. `/upload` oder `/`.

AUSGABEN

string[]

BEISPIELE

# Gibt alle Dateien im Verzeichnis `/export` zurück.
Get-FtpDir -Server 'ftp.example.com' -User 'admin' -PlainPassword 'secret' -RemoteFolder '/export'
# Gibt alle Unterverzeichnisse im Root-Verzeichnis zurück (FTPS aktiv).
Get-FtpDir -Server 'ftp.example.com' -Protocol 'ftps' -User 'cn' -PasswordPath 'C:\Users\cn\.eulandaconnect\pw.xml' -DirType 'directory' -Verbose

VERWANDTE LINKS

Get-FtpFileAge

Get-FtpFileDate

Get-FtpFileSize

Get-FtpNewestFilename

Get-FtpOldestFilename

New-FtpFolder

Receive-FtpFile

Remove-FtpFile

Remove-FtpFilesOlderThan

Remove-FtpFolder

Rename-FtpFile

Rename-FtpFolder

Send-FtpFile

Test-FtpFile

Test-FtpFolder

HINWEISE