FtpUpload@1 – FTP-Upload v1-Aufgabe

Verwenden Sie diese Aufgabe, um Dateien mithilfe von FTP oder sicher mit FTPS auf einen Remotecomputer hochzuladen.

Diese Version der Aufgabe ist veraltet; verwenden Sie FtpUpload@2.

Syntax

# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

Eingänge

credentialsOption - Authentifizierungsmethode
Eingabealias: credsType. string. Erforderlich. Zulässige Werte: serviceEndpoint (FTP-Dienstverbindung), inputs (Anmeldeinformationen eingeben). Standardwert: serviceEndpoint.

Gibt die Authentifizierungsmethode an. Verwenden Sie eine FTP-Dienstverbindung, oder geben Sie die Verbindungsanmeldeinformationen ein.

serverEndpoint - FTP-Dienstverbindung
string. Erforderlich, wenn credsType = serviceEndpoint.

Gibt die Dienstverbindung für den FTP-Server an. Um einen zu erstellen, klicken Sie auf den Link "Verwalten", und erstellen Sie eine neue generische Dienstverbindung, und geben Sie dann die FTP-Server-URL für die Server-URL ein, z. B. ftp://server.example.com, und die erforderlichen Anmeldeinformationen.

Sichere Verbindungen werden unabhängig vom angegebenen Protokoll (ftp:// oder ftps://) immer hergestellt, wenn der Zielserver FTPS unterstützt. Um nur sichere Verbindungen zuzulassen, verwenden Sie das ftps://-Protokoll, z. B. ftps://server.example.com. Verbindungen mit Servern, die FTPS nicht unterstützen, schlagen fehl, wenn ftps:// angegeben ist.

serverUrl - Server-URL-
string. Erforderlich, wenn credsType = inputs.

Gibt die URL für den FTP-Server an.

username - Benutzername
string. Erforderlich, wenn credsType = inputs.

Gibt den Benutzernamen für die FTP-Verbindung an.

password - Kennwort
string. Erforderlich, wenn credsType = inputs.

Gibt das Kennwort für die FTP-Verbindung an.

rootDirectory - Stammordner
Eingabealias: rootFolder. string. Erforderlich.

Gibt den Quellordner an, aus dem Dateien hochgeladen werden sollen.

filePatterns - Dateimuster
string. Erforderlich. Standardwert: **.

Gibt die Dateipfade oder Muster der hochzuladenden Dateien an. Die Zeichenfolge unterstützt mehrere Linien von Miniübereinstimmungsmustern. Erfahren Sie mehr über Dateiabgleichsmuster.

remoteDirectory - Remoteverzeichnis-
Eingabealias: remotePath. string. Erforderlich. Standardwert: /upload/$(Build.BuildId)/.

Gibt das Verzeichnis auf dem Remote-FTP-Server an, auf dem die Aufgabe Dateien hochlädt.

clean - Remoteverzeichnis löschen
boolean. Standardwert: false.

Löscht das Remoteverzeichnis, einschließlich seiner Inhalte, vor dem Hochladen.

cleanContents - Löschen von Remoteverzeichnisinhalten
boolean. Wahlfrei. Wird verwendet, wenn clean = false. Standardwert: false.

Löscht vor dem Hochladen rekursiv alle Inhalte im Remoteverzeichnis. Das vorhandene Verzeichnis wird nicht gelöscht. Verwenden Sie stattdessen clean, um eine bessere Leistung zu erzielen.

overwrite - überschreiben
boolean. Standardwert: true.

Überschreibt vorhandene Dateien im Remoteverzeichnis.

preservePaths - Speichern von Dateipfaden
boolean. Standardwert: false.

Wenn diese Option ausgewählt ist, wird die relative lokale Verzeichnisstruktur unter dem Remoteverzeichnis neu erstellt, in das Dateien hochgeladen werden. Andernfalls werden Dateien direkt in das Remoteverzeichnis hochgeladen, ohne zusätzliche Unterverzeichnisse zu erstellen.

Angenommen, Ihr Quellordner ist /home/user/source/, der die Datei foo/bar/foobar.txtenthält, und Ihr Remoteverzeichnis lautet: /uploads/. Wenn dieser boolesche Wert ausgewählt ist, wird die Datei in /uploads/foo/bar/foobar.txthochgeladen. Wenn dieser boolesche Wert nicht ausgewählt ist, wird die Datei in /uploads/foobar.txthochgeladen.

trustSSL - Vertrauensstellungsserverzertifikat
boolean. Standardwert: false.

Vertraut dem SSL-Zertifikat des FTP-Servers mit ftps://, auch wenn es selbstsigniert ist oder von einer Zertifizierungsstelle (CA) nicht überprüft werden kann.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Verwenden Sie diese Aufgabe, um Dateien mithilfe von FTP oder sicher mit FTPS auf einen Remotecomputer hochzuladen.

Hinweis

Es ist eine neuere Version dieser Aufgabe unter FtpUpload@2verfügbar.

Wo erhalte ich weitere Informationen zu Dateiabgleichsmustern?

• Referenz zu Dateiabgleichsmustern

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Das Festlegen von Variablen ist deaktiviert.
Agentversion	2.182.1 oder höher
Vorgangskategorie	Nützlichkeit