Secure Shell (SSH)-Connector-Methoden

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Die Secure Shell (SSH)-Connector-Methoden stellen eine SSH-Verbindung her, führen Befehle über die hergestellte Verbindung aus und trennen die Sitzung.

    Connect

    Stellt eine SSH-Verbindung her. Geben Sie die Informationen an, die für die Verbindung mit einem Remote-Computer erforderlich sind.

    Wählen Sie das Einstellungssymbol ( Symbol „Einstellungen“), um den Authentifizierungstyp auszuwählen.

    Unterstützte Authentifizierungstypen sind Password, KeyboardInteractive und KeyFileAuthentication.Das Konfigurationsfenster für den Authentifizierungstyp, in dem Password, KeyboardInteractive und KeyFileAuthentication als Authentifizierungstypen angezeigt werden.

    Passwort ist der Standardauthentifizierungstyp.

    Tabelle : 1. Connect-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp
    HostName Hostname des Remote-Servers oder IP-Adresse. Daten In Zeichenfolge
    Anwendername Anwendername des SSH-Accounts. Daten In Zeichenfolge
    Passwort

    Sichere Zeichenfolgendarstellung des Passworts. Passwort des SSH-Accounts.

    Sie können die SecureStringEncode-Komponente verwenden, um das sichere Zeichenfolgenpasswort zu codieren, wie im folgenden Beispiel erwähnt. Weitere Informationen finden Sie unter Verwenden Sie die SecureStringEncode-Komponente.
    Abbildung : 1. Verbindungsmethode mit Passwortparameter
    Die SecureStringEncode-Komponente ist mit der Connect-Methode verbunden, um das codierte Passwort zu übergeben.

    Nachdem Sie diese Aufgabe ausgeführt haben, können Sie eine Verbindung zum Remote-Server herstellen.

    Daten In SecureString
    Port Optional. Die Portnummer für die SSH-Verbindung. Der Standardwert ist 22. Daten In Ganzzahl
    CreateShell Optional. Bei „wahr“ wird bei erfolgreicher Verbindung ein Shell-Stream erstellt. Jeder Befehl, der für diese Verbindung ausgeführt wird, verwendet die Shell.

    Bei „falsch“ wird bei jedem Befehl, der für diese Verbindung ausgeführt wird, nicht die Shell verwendet.

    Der Standardwert ist „wahr“.

    Daten In Boolean
    KeyboardInteraktiveAuth Passwort als Herausforderung.

    Bei „wahr“ fordert der Server den Client zur Eingabe eines Passworts auf, um die Identität des Anwenders zu überprüfen. Der im Passwortparameter angegebene Wert wird als Antwort vom Client freigegeben.

    Dieser Parameter wird nur angezeigt, wenn KeyboardInteraktiv Ist im Authentifizierungstyp ausgewählt.

    Daten In Boolean
    KeyFilepath Pfad des privaten Schlüssels.

    Dieser Parameter wird nur angezeigt, wenn KeyFileAuthentication Ist im Authentifizierungstyp ausgewählt.

    Daten In Zeichenfolge
    Passwortsatz Optional. Wenn der private Schlüssel mit der Passphrase verschlüsselt wird, wird im Passphrase-Parameter derselbe Wert angegeben, um den privaten Schlüssel zu verwenden.

    Dieser Parameter wird nur angezeigt, wenn KeyFileAuthentication Ist im Authentifizierungstyp ausgewählt.

    Daten In Zeichenfolge

    Befehl ausführen

    Führen Sie nach dem Herstellen einer SSH-Verbindung Befehle über die hergestellte Verbindung mit der RunCommand-Methode aus.

    Tabelle : 2. RunCommand-Methodenparameter
    Parameter Beschreibung Datenporttyp Datentyp
    Befehl Befehle, die auf dem Remote-SSH-Server ausgeführt werden müssen, z. B. Nachrichten oder Skripts, können gültige Shell-Befehle oder ausführbare Befehle sein, die der Remote-Server verstehen kann.

    Beispiel: Hallo .

    Abbildung : 2. RunCommand-Methode: Befehlsparameter
    Befehl, der als „Echo hallo“ in der AusführungsCommand-Methode des Befehlsparameters eingegeben wurde
    Daten In Zeichenfolge
    Zeitüberschreitung Optional. Der Parameter, der die maximale Wartezeit (in Sekunden) für die Ausgabe des Befehls vom SSH-Server angibt, wenn eine interaktive Shell verwendet wird.

    Der Standardwert ist 30.

    Daten In Ganzzahl
    Zurück Das Ergebnis des ausgeführten Befehls.

    Beispiel: Nach der Ausführung der Automatisierung wird im Parameter „Datenvorschau des Rückgabeparameters“ „Hallo“ angezeigt.

    Abbildung : 3. Rückgabeparameter der RunCommand-Methode
    Datenvorschauen als Hallo, nachdem der Befehl ausgeführt wurde
    Daten Aus Zeichenfolge

    Trennen

    Trennen Sie nach der Ausführung von Befehlen die hergestellte Verbindung mit der Methode Trennen.

    Das folgende Beispiel zeigt die gesamte Automatisierung nach dem Hinzufügen der Methode Trennen.

    Abbildung : 4. Trennungsmethode
    Beispiel für SSH-Connector-Automatisierungs-Workflow.