Befehlszeilenreferenz für Microsoft Tunnel-Gateway

Die Informationen in dieser Referenz für Microsoft Tunnel-Gateway werden zur Unterstützung der Installation und Wartung der Tunnelinstallation in Ihrer Umgebung bereitgestellt.

mst-cli-Befehlszeilentool für Microsoft Tunnel-Gateway

Mst-cli ist ein Befehlszeilentool für Microsoft Tunnel-Gateway. Dieses Tool ist auf dem Linux-Server verfügbar, nachdem der Tunnel die Installation abgeschlossen hat, und befindet sich unter /usr/sbin/mst-cli. Einige Aufgaben, für die Sie dieses Tool verwenden können, sind:

• Rufen Sie Informationen zum Tunnelserver ab.
• Konfigurieren oder aktualisieren Sie die Konfiguration des Tunnelservers.
• Starten Sie den Tunnelserver neu.
• Deinstallieren Sie den Tunnelserver.

Im Folgenden werden häufige Verwendungen des Tools über die Befehlszeile aufgeführt.

Befehlszeilenschnittstelle:

• mst-cli –help - Verwendung: mst-cli [Befehl]

  Befehle

  • agent - Operieren Sie mit der Agentenkomponente.
  • server - Arbeiten Sie mit der Serverkomponente.
  • uninstall - Deinstallieren Sie Microsoft Tunnel.
  • eula - Zeigen Sie die End-User Lizenzvereinbarung (EULA) an.
  • import_cert - Importieren oder aktualisieren Sie das TLS-Zertifikat.

• mst-cli agent –help - Verwendung: mst-cli agent [Befehl]

  Befehle:

  • logs - Zeigen Sie die Agentenprotokolle an. (Verwenden Sie -h für weitere Informationen.)
  • status- Zeigen Sie den Agenten-Status an.
  • start - Starten Sie den Agent-Dienst.
  • stop - Stoppen Sie den Agent-Dienst.
  • restart - Starten Sie den Agent-Dienst neu.

• mst-cli agent logs help - Verwendung: mst-cli-Agent-Protokolle [Flags]

  Kennzeichen:

  • -f, --follow - Verfolgen Sie die Protokollausgabe. Der Standardwert ist „false“.
  • --since string - Protokolle seit ZEITSTEMPEL anzeigen.
  • --tail uint - Gibt die angegebene Anzahl von ZEILEN am Ende der Protokolle aus. Der Standardwert ist Null (0), wodurch alle Zeilen gedruckt werden.
  • -t, --timestamps - Geben Sie die Zeitstempel im Protokoll aus.

• mst-cli agent status - Die folgenden Rückgaben sind Beispiele für Ergebnisse, die Sie möglicherweise sehen:

  • Zustand: wird ausgeführt
  • Gesundheit: gesund

• mst-cli agent start - Startet den Agenten, wenn er gestoppt ist.

• mst-cli agent stop - Stoppt den Agenten. Muss nach dem Beenden manuell gestartet werden.

• mst-cli agent restart - Startet den Agenten neu.

• mst-cli server --help - Verwendung: mst-cli server [Befehl]

  Befehle:

  • logs - Serverprotokolle anzeigen. Verwenden Sie -h für weitere Informationen.
  • status- Zeigen Sie den Status des Servers an.
  • start - Starten Sie den Serverdienst.
  • stop - Stoppen Sie den Serverdienst.
  • restart - Starten Sie den Serverdienst neu.
  • show - Zeigen Sie verschiedene Serverstatistiken an. Verwenden Sie -h für weitere Informationen.

• mst-cli server logs –help - Verwendung: mst-cli-Serverprotokolle [Flags]

  Kennzeichen:

  • -f, --follow - Verfolgen Sie die Protokollausgabe. Der Standardwert ist „false“.
  • --since string - Protokolle seit ZEITSTEMPEL anzeigen
  • --tail uint - Gibt die angegebene Anzahl von ZEILEN am Ende der Protokolle aus. Der Standardwert ist Null (0), wodurch alle Zeilen gedruckt werden.
  • -t, --timestamps - Geben Sie die Zeitstempel im Protokoll aus.

• mst-cli server status - Die folgenden Rückgaben sind Beispiele für Ergebnisse, die Sie möglicherweise sehen:

  • Zustand: wird ausgeführt
  • Gesundheit: gesund

• mst-cli server start – Startet den Server, wenn er gestoppt ist.

• mst-cli server stop - Stoppt den Server. Muss nach dem Beenden manuell gestartet werden.

• mst-cli server restart - Startet den Server neu.

• mst-cli server show

  • show status- Druckt den Status und die Statistiken des Servers.
  • show users - Druckt die verbundenen Benutzer.
  • show ip bans - Druckt die gesperrten IP-Adressen.
  • show ip ban points - Gibt alle bekannten IP-Adressen aus, die Punkte haben.
  • show iroutes - Druckt die Routen, die von Benutzern des Servers bereitgestellt werden.
  • show sessions all – Gibt alle Sitzungs-IDs aus.
  • show sessions valid - Druckt alle gültigen für Wiederverbindungssitzungen.
  • show session [SID] – Gibt Informationen zur angegebenen Sitzung aus.
  • show user [NAME] – Druckt Informationen zum angegebenen Benutzer.
  • show id [ID] – Druckt Informationen zur angegebenen ID.
  • show events - Enthält Informationen zum Verbinden von Benutzern.
  • show cookies all - Alias für Show-Sessions alle.
  • show cookies valid - Alias für Showsitzungen gültig.

Umgebungsvariablen

Im Folgenden finden Sie Umgebungsvariablen, die Sie möglicherweise konfigurieren möchten, wenn Sie die Microsoft Tunnel-Gateway-Software auf dem Linux-Server installieren. Diese Variablen befinden sich in der Umgebungsdatei /etc/mstunnel/env.sh:

• http_proxy=[address] – Die HTTP-Adresse für Ihren Proxyserver.
• https_proxy=[address] – Die HTTPS-Adresse für Ihren Proxyserver.

Datenpfade

Während der Serverinstallation hinzugefügte Files

/etc/mstunnel:

• admin-settings.json:

  • Enthält die serialisierte Serverkonfiguration aus Intune.
  • Erstellt, nachdem der Server registriert wurde.

• agent-info.json:

  • Wird erstellt, wenn die Registrierung abgeschlossen ist.
  • AgentId, IntuneTenantId, AADTenantId und das Agent-Zertifikat RenewalDate.
  • Aktualisiert über die Erneuerung des Agent-Zertifikats.

• private/agent.p12:

  • PFX-Zertifikat, das für die Agent-Authentifizierung bei Intune verwendet wird.
  • Automatisch verlängert.

• version-info.json:

  • Enthält Versionsinformationen zu den verschiedenen Komponenten.
  • ConfigVersion, DockerVersion, AgentImageHash, AgentCreateDate, ServerImageHash, ServerCreateDate.

• ocserv.conf:

  • Serverkonfiguration

• Images_configured

Die zum Erstellen der Container verwendeten Docker-Images:

• agentImageDigest
• serverImageDigest

Beispiel für admin-settings.json

{
"PolicyName": "Auto Generated Policy for rh7vm",
   "DisplayName": "rh7vm Policy",
   "Description": "This policy was auto generated for rh7vm",
   "Network": "169.100.0.0/16",
   "DNSServers": ["168.63.129.16"],
   "DefaultDomainSuffix": "nmqjwlanybmubp4imht0k2b4qd.xx.internal.cloudapp.net",
   "RoutesInclude": ["default"],
   "RoutesExclude": [],
   "ListenPort": 443
}

Docker-Befehle

Im Folgenden sind allgemeine Befehle für Docker aufgeführt, die hilfreich sein können, wenn Sie Probleme auf einem Tunnelserver untersuchen müssen.

Befehlszeilenschnittstelle:

• docker ps –a – Alle Container anzeigen.

  • mstunnel-server – Dieser Container führt die ocserv-Serverkomponenten aus und verwendet den eingehenden Port 443 (Standard) oder eine benutzerdefinierte Portkonfiguration.
  • mstunnel-agent: Dieser Container führt den Intune-Connector aus und verwendet den ausgehenden Port 443.

• So starten Sie Docker neu:

  • systemctl restart docker

• So führen Sie etwas in einem Container aus:

  • docker exec –it mstunnel-server bash
  • docker exec –it mstunnel-agent bash

Podman-Befehle

Im Folgenden finden Sie Befehle für Podman, die hilfreich sein können, wenn Sie Probleme auf einem Tunnelserver untersuchen müssen. Weitere Befehle, die Sie mit Podman verwenden können, finden Sie unter Docker-Befehle.

• sudo podman images - Alle ausgeführten Container auflisten.
• sudo podman stats - Zeigen Sie die CPU-Auslastung des Containers, die MEM-Auslastung, das Netzwerk und die Block-E/A an.
• sudo podman port mstunnel-server- Listen Sie die Port-Zuordnungen vom Tunnel-Server zum lokalen Linux-Host auf.

Linux-Befehle

Im Folgenden finden Sie allgemeine Linux-Befehle, die Sie mit einem Tunnelserver verwenden können.

• sudo su – Lässt Sie auf der Box anfeuern. Verwenden Sie diesen Befehl, bevor Sie die folgenden Befehle ausführen und bevor Sie "mstunnel-setup" ausführen.

• ls – Inhalt des Verzeichnisses auflisten.

• ls – l – Listet den Inhalt des Verzeichnisses einschließlich der Zeitstempel auf.

• cd – in ein anderes Verzeichnis wechseln. Ändert Sie beispielsweise cd /etc/test/stuff vom Stammverzeichnis zum Unterordner >etc, zum Testunterordner> und dann zum Ordner stuff.

• cp <source> <destination> - Nützlich, um die Zertifikate an den richtigen Ort zu kopieren.

• ln –s <source> <target> - Erstellen Sie einen Softlink.

• curl <URL> – Überprüft den Zugriff auf eine Website. Beispiel: curl https://microsoft.com

• ./<filename> - Führen Sie ein Skript aus.

Laden Sie ip_tables manuell

Verwenden Sie die folgenden Befehle, um nach ip_tables im Linux Serverkernel zu suchen und diese gegebenenfalls manuell zu laden. Verwenden Sie den sudo-Kontext:

• Überprüfen Sie, ob ip_tables auf dem Server vorhanden sind: lsmod |grep ip_tables
• Erstellen Sie eine Konfigurationsdatei, die die ip_tables beim Starten des Servers in den Kernel lädt: echo ip_tables > /etc/modules-load.d/mstunnel_iptables.conf
• So wird ip_tables sofort in den Kernel geladen: /sbin/modprobe ip_tables