Bedienungshandbuch
Alle Funktionen von EasySwitch365 Schritt für Schritt erklärt – von der ersten Kundensitzung bis zu den PowerShell-Befehlen, die direkt im Kunden-Tab angemeldet werden. Stand: Juni 2026 · Version 0.3.
1. Was EasySwitch365 ist
EasySwitch365 ist die Kommandozentrale für Microsoft 365 für MSPs und IT-Administratoren. Jeder Kunde (Tenant) bekommt eine vollständig getrennte Browser-Sitzung. Du verwaltest mehrere Kunden parallel, ohne dich ständig ab- und wieder anzumelden und ohne dass sich Anmeldungen, Cookies oder Tokens vermischen.
Die Anwendung besteht aus drei Bereichen:
- Kundenliste (links) – jeder Eintrag ist eine eigene, isolierte Session.
- Arbeitsbereich (Mitte) – der eingebettete Browser mit den Microsoft-365-Portalen und Schnellzugriffen.
- Werkzeuge – die Wissensdatenbank mit fertigen Befehlen und die integrierte PowerShell-Konsole, die sich direkt in der Kundensitzung anmeldet.
2. Systemvoraussetzungen
| Plattform | Voraussetzung |
|---|---|
| Windows | Windows 10/11 (64-Bit). Für die PowerShell-Befehle wird PowerShell 7 empfohlen (lässt sich in der App per Knopfdruck über winget installieren). Windows PowerShell 5.1 ist als Rückfall vorhanden. |
| macOS | macOS 11+ (Apple Silicon). Für die PowerShell-Befehle wird PowerShell 7 benötigt (in der App per Knopfdruck über Homebrew installierbar). |
Für die reine Tenant-Verwaltung im Browser ist PowerShell nicht nötig – erst für die Konsolen-Befehle.
3. Installation & Lizenz aktivieren
- Installationspaket herunterladen und installieren (Windows: ZIP entpacken und
EasySwitch365.exestarten · macOS: DMG öffnen und die App in „Programme" ziehen). - Beim ersten Start nach dem Lizenzschlüssel gefragt – eintragen und auf Aktivieren klicken.
- Die Lizenz wird gerätegebunden aktiviert und danach einmal täglich online geprüft. Eine kurze Offline-Zeit überbrückt die App; bei längerem Ausfall oder gekündigtem Abo wird sie gesperrt.
4. Kunden anlegen & verwalten
Über „+ Kunde hinzufügen" (unten links) legst du eine neue isolierte Session an. Im Dialog stehen:
| Feld | Bedeutung |
|---|---|
| Anzeigename | Name des Kunden in der Liste (z. B. „Wynkraft Projects GmbH"). |
| Startseite | Welches Portal beim Öffnen geladen wird – Admin Center, Entra, Exchange usw. |
| Eigene URL | Optional eine abweichende Start-URL (z. B. ein Kunden-SharePoint). |
| Logo / Buchstabe | Eigenes Logo hochladen oder einen Buchstaben mit Farbe als Erkennungszeichen verwenden. |
Einen Eintrag bearbeitest du über das Stift-Symbol; dort lässt sich auch das Logo entfernen oder der Kunde löschen. Beim Löschen wird auch die zugehörige isolierte Session vom Gerät entfernt.
5. Der Arbeitsbereich
Schnellzugriffe (Werkzeugleiste oben)
Mit einem Klick springst du in der aktiven Kundensitzung direkt in das jeweilige Portal – ohne erneute Anmeldung:
| Schaltfläche | Öffnet | Wofür |
|---|---|---|
| Admin | admin.microsoft.com | Microsoft 365 Admin Center – Benutzer, Lizenzen, Abrechnung. |
| Entra | entra.microsoft.com | Entra ID (Azure AD) – Identitäten, Gruppen, Conditional Access. |
| Exchange | admin.exchange.microsoft.com | Exchange Admin Center – Postfächer, Mail-Flow. |
| Defender | security.microsoft.com | Microsoft Defender / Security Center. |
| Intune | intune.microsoft.com | Geräteverwaltung & Endpoint Management. |
| Azure | portal.azure.com | Azure-Portal für Cloud-Ressourcen. |
Tabs, Adressleiste & Navigation
Innerhalb einer Kundensitzung kannst du mehrere Tabs öffnen. Links/Rechts-Pfeile und das Neu-laden-Symbol funktionieren wie im Browser. Öffnet ein Portal ein neues Fenster (z. B. „in neuem Tab"), bleibt es in derselben Kundensitzung angemeldet.
Reset
Die Schaltfläche Reset lädt die aktuelle Kundensitzung neu und meldet sie ab (löscht Cookies/Tokens dieses Kunden) – nützlich, wenn eine Anmeldung „hängt". Andere Kunden sind davon nicht betroffen.
6. Sitzungs-Isolation – wie es funktioniert
Jeder Kunde läuft in einer eigenen Sitzungs-Partition. Cookies, Anmelde-Tokens und zwischengespeicherte Daten eines Kunden sind technisch von allen anderen getrennt – so wie separate Browser-Profile, nur automatisch.
- Die Sitzungsdaten liegen lokal und verschlüsselt auf deinem Gerät (macOS-Keychain bzw. Windows-DPAPI).
- Es gibt keinen Passwort-Tresor und keine Cloud-Sammlung von Zugangsdaten. Die Anmeldung läuft immer direkt zwischen deinem Gerät und Microsoft.
- Du kannst also gleichzeitig bei Kunde A als Global Admin und bei Kunde B als anderer Admin angemeldet sein – ohne Konflikte.
7. Die Wissensdatenbank
Über „Wissen" (Werkzeugleiste) öffnest du eine Sammlung fertiger PowerShell-Befehle für die häufigsten Admin-Aufgaben – gruppiert nach Thema und durchsuchbar.
Platzhalter werden automatisch gefüllt
In den Befehlen steht der Platzhalter {tenant}. Er wird automatisch durch die Domain des aktiven Kunden ersetzt. Werte in spitzen Klammern – z. B. <user@domain> – musst du noch durch echte Adressen ersetzen.
Befehl übernehmen: einfügen oder kopieren
Jede Karte hat zwei Aktionen:
- In Konsole einfügen – setzt den fertigen Befehl direkt in die Eingabezeile der integrierten Konsole (mit eingesetzter Kunden-Domain). Du musst nur noch die
<…>-Werte anpassen und Enter drücken. - Kopieren – legt denselben Befehl in die Zwischenablage, falls du ihn woanders einfügen willst.
Eigene Befehle speichern
Über das + in der Wissensdatenbank legst du eigene Einträge an (Thema, Titel, Beschreibung, Befehl). Diese bleiben gespeichert und tauchen neben den mitgelieferten Befehlen auf. Du kannst {tenant} auch in eigenen Befehlen verwenden.
Mitgelieferte Kategorien
Exchange-Verbindung · Postfach-Infos · Berechtigungen (Vollzugriff, Senden als, im Auftrag) · Gesendete Elemente ins Shared-Postfach · Shared Mailbox anlegen/umwandeln · Weiterleitung & Abwesenheit · Nachrichtenverfolgung · Entra/Identität über Microsoft Graph (Passwort zurücksetzen, Konto deaktivieren, Benutzer-Infos) · Teams & Security/Compliance · Setup (Module installieren).
8. Die integrierte Konsole
Über „Konsole" öffnest du unten eine PowerShell-Konsole, die zur aktiven Kundensitzung gehört. Sie zeigt oben an, welche Shell läuft („PowerShell 7" oder „Windows PowerShell").
Höhe anpassen
Am oberen Rand der Konsole sitzt ein Ziehgriff. Damit ziehst du die Konsole größer oder kleiner – der Browser-Bereich passt sich automatisch an. Die Höhe bleibt gespeichert. (Mac und Windows gleich.)
Die Schaltflächen
| Schaltfläche | Funktion |
|---|---|
| ⚙ Einrichten | Installiert einmalig die nötigen PowerShell-Module (Exchange Online, Microsoft Graph, Teams) für den aktuellen Benutzer. Auf Windows wird vorher die Ausführungsrichtlinie passend gesetzt. |
| ⚡ Exchange verbinden | Meldet sich an Exchange Online an – per Geräte-Code direkt im Kunden-Tab (siehe unten). |
| ⚡ Graph | Verbindet mit Microsoft Graph (Connect-MgGraph -UseDeviceCode). |
| ⚡ Teams | Verbindet mit Microsoft Teams (Connect-MicrosoftTeams -UseDeviceAuthentication). |
| Leeren | Löscht die Konsolenausgabe. |
| Neustart | Startet die Shell neu (z. B. nachdem PowerShell 7 frisch installiert wurde – danach läuft die Konsole als PowerShell 7). |
Eingabe & Verlauf
Befehle tippst du in die Eingabezeile und bestätigst mit Enter. Mit ↑ / ↓ blätterst du durch zuvor eingegebene Befehle.
Geräte-Code direkt im Kunden-Tab
Das ist die Besonderheit: Bei den Verbinden-Befehlen ergänzt EasySwitch365 automatisch den Geräte-Code-Schalter und öffnet die Microsoft-Bestätigungsseite im Tab des aktiven Kunden, der Code liegt in der Zwischenablage. So wird die Anmeldung der richtigen Kundensitzung zugeordnet – ohne externen Browser und ohne Kontoverwechslung.
Connect-MgGraph und Connect-MicrosoftTeams funktionieren auch mit Windows PowerShell 5.1.
9. Microsoft-Dienste & wann man was verbindet
| Dienst | Befehl | Wofür im Alltag |
|---|---|---|
| Exchange Online | Connect-ExchangeOnline | Postfächer, Berechtigungen (Vollzugriff, Senden als), Shared Mailboxes, Mail-Flow, Weiterleitungen, Nachrichtenverfolgung. Der häufigste Anwendungsfall. |
| Microsoft Graph | Connect-MgGraph | Benutzer anlegen/sperren, Passwörter, Lizenzen zuweisen, Gruppen, Anmelde-/Audit-Logs, Conditional Access, Intune. Zentral und zukunftssicher. |
| Microsoft Teams | Connect-MicrosoftTeams | Teams-Richtlinien, Telefonie, Meeting- und Raum-Einstellungen. |
| Security & Compliance | Connect-IPPSSession | Inhaltssuchen (eDiscovery), Aufbewahrung, DLP. Gleiches Modul wie Exchange. |
MSOnline und AzureAD werden von Microsoft eingestellt – ihre Aufgaben übernimmt Microsoft Graph. EasySwitch365 setzt deshalb auf Graph.10. Wie die Anmeldung technisch funktioniert (API)
Die Microsoft-365-Verwaltung läuft im Hintergrund über offizielle REST-APIs von Microsoft – allen voran die Microsoft-Graph-API. Die PowerShell-Module (Microsoft.Graph, ExchangeOnlineManagement, MicrosoftTeams) sind komfortable „Hüllen" um diese APIs: Ein Cmdlet wie Update-MgUser sendet im Hintergrund einen Graph-API-Aufruf.
Der Geräte-Code-Ablauf (Device Code Flow)
- Du klickst auf einen Verbinden-Befehl. PowerShell fordert bei Microsoft einen kurzen Geräte-Code an.
- EasySwitch365 öffnet die Bestätigungsseite
microsoft.com/deviceloginim Tab des aktiven Kunden und legt den Code in die Zwischenablage. - Du bestätigst dort mit dem richtigen Admin-Konto. Weil das im Kunden-Tab passiert, ist die Anmeldung dieser Kundensitzung zugeordnet.
- Microsoft stellt PowerShell ein zeitlich begrenztes Zugriffstoken aus. Alle folgenden Befehle nutzen dieses Token, bis du
Disconnect-…ausführst oder es abläuft.
Warum dieser Umweg? Ein PowerShell-Token und ein Browser-Cookie sind technisch verschieden. Der Geräte-Code ist die offizielle Brücke, damit die Konsole genau die Identität nutzt, die zur sichtbaren Kundensitzung passt – statt eines beliebig im System angemeldeten Kontos.
11. Sprache & Erscheinungsbild
Unten links wählst du die Sprache (Deutsch, Englisch, Spanisch, Französisch, Türkisch, Arabisch) und schaltest zwischen hellem und dunklem Design um. Die Auswahl bleibt gespeichert.
12. Sicherheit & Datenschutz
- Lokale Verarbeitung: Alle Kundendaten und Sitzungen bleiben auf deinem Gerät und sind vom Betriebssystem verschlüsselt.
- Keine Cloud-Sammlung: EasySwitch365 speichert keine Microsoft-Zugangsdaten und überträgt keine Arbeitsdaten an uns.
- Einzige Außenverbindung: die tägliche Lizenzprüfung (nur Schlüssel + anonymer Geräte-Fingerabdruck).
- Signaturgeprüfte Lizenz (Ed25519), gerätegebunden; verschlüsselte Übertragung (TLS) überall.
Mehr dazu in der Datenschutzerklärung.
13. Fehlerbehebung
„PowerShell 7 fehlt" / Konsole läuft als „Windows PowerShell"
Oben in der Konsole erscheint eine Leiste mit „PowerShell 7 installieren". Auf Windows installiert das per winget, auf Mac per Homebrew – direkt in der Konsole. Danach auf Neustart klicken; ein kompletter App-Neustart ist nicht nötig.
„Exchange verbinden" meldet einen Fenster-Handle-Fehler
Tritt nur in Windows PowerShell 5.1 auf. Lösung: PowerShell 7 installieren (Button oben) und auf Neustart klicken – dann läuft die Anmeldung sauber im Kunden-Tab.
SmartScreen (Windows) bzw. Gatekeeper (macOS) blockiert den Start
In der aktuellen Vorab-Phase ist die App noch nicht signiert. Windows: „Weitere Informationen" → „Trotzdem ausführen". macOS: per Rechtsklick → „Öffnen". Mit der finalen Signierung entfällt das.
Ein Befehl bringt „… is not recognized"
Das passende Modul ist noch nicht installiert – einmal auf ⚙ Einrichten klicken.
Noch Fragen? Schreib uns an [email protected].
EasySwitch365