# RDS-Manager — Benutzerhandbuch

## Einführung

Der RDS-Manager ist das zentrale Dashboard für die Verwaltung Ihrer Windows Remote Desktop Services Infrastruktur. Er ersetzt Citrix als VDI-Lösung und nutzt die in Windows Server enthaltenen RDS-Funktionen.

## Anmeldung

Öffnen Sie den Browser und navigieren Sie zu `https://rds-manager.c3po42.de` (oder `http://localhost:8990` bei lokaler Installation).

Geben Sie Ihren Benutzernamen und Ihr Passwort ein. Je nach Rolle sehen Sie unterschiedliche Funktionen:

- **ADMIN** — Vollzugriff (Benutzer, Collections, Software, Farm-Updates)
- **OPERATOR** — Operativer Zugriff (Drain, Reboot, Sessions, Drucker)
- **VIEWER** — Nur Lesezugriff (Dashboard, Monitoring)

## Dashboard

Das Dashboard zeigt auf einen Blick:

- **Hosts** — Gesamtzahl, Online, Wartungsmodus, Offline
- **Sessions** — Aktive und getrennte Sessions
- **CPU/RAM** — Durchschnittliche Auslastung
- **Session Collections** — Übersicht pro Collection mit Host- und Session-Zahlen
- **Image-Versionen** — Verteilung der Golden-Image-Versionen

## RDS-Hosts

### Host-Kacheln

Jeder Host wird als Kachel mit folgenden Informationen dargestellt:
- Hostname und IP-Adresse
- Collection-Zugehörigkeit
- CPU- und RAM-Auslastung (Balken)
- Anzahl aktiver Sessions
- Status (Online, Wartungsmodus, Offline)

### Host-Aktionen

- **Drain** — Versetzt den Host in den Wartungsmodus. Neue Sessions werden auf andere Hosts verteilt.
- **Activate** — Hebt den Wartungsmodus auf. Der Host nimmt wieder neue Sessions an.
- **Reboot** — Startet den Host neu (nur im Wartungsmodus ohne aktive Sessions).
- **Sessions migrieren** — Trennt alle Sessions. Benutzer werden automatisch auf freie Hosts umgeleitet.

### Discovery

Über die Discovery-Funktion können neue RDS-Hosts im Netzwerk gefunden werden:
1. IP-Range eingeben (z.B. `10.0.1.50-10.0.1.90`)
2. "Scannen" klicken
3. Gefundene Hosts prüfen und importieren

## Sessions

Die Session-Übersicht zeigt alle aktiven und getrennten RDS-Sessions:

- **Benutzer** — Anmeldename und Anzeigename
- **Host** — Auf welchem Server die Session läuft
- **Client** — IGEL-Name und IP-Adresse
- **Anwendungen** — Laufende Programme
- **Status** — Active oder Disconnected
- **Idle** — Seit wann inaktiv

### Session-Aktionen

- **Trennen** (Disconnect) — Trennt die Verbindung. Der Benutzer kann sich erneut verbinden.
- **Abmelden** (Logoff) — Meldet die Session komplett ab.

## Drucker-Mappings

Drucker werden automatisch basierend auf der Client-IP-Adresse zugeordnet:

| Client-IP-Range | Drucker |
|----------------|---------|
| 10.0.1.100–10.0.1.119 | \\\\PRINT-SRV01\\STA-A1-KYOCERA |
| 10.0.2.50–10.0.2.79 | \\\\PRINT-SRV02\\STA-B1-KYOCERA |

### Mapping erstellen

1. Tab "Drucker" öffnen
2. "Neues Mapping" klicken
3. Name, Standort, IP-Range und Drucker-UNC-Pfad eingeben
4. Optional: Als Standarddrucker markieren
5. Speichern

## Software

Im Tab "Software" sehen Sie alle im Golden Image installierten Anwendungen:

- **Name und Version** — z.B. "SAP GUI 8.00 Patch 4"
- **Image-Version** — In welchem Golden Image enthalten
- **Typ** — GOLDEN_IMAGE (fest im Image), MSIX (App Attach), SCCM (verteilt)
- **Installiert am** — Installationsdatum

## Farm-Updates

Farm-Updates ermöglichen das kontrollierte Aktualisieren aller RDS-Hosts:

### Update erstellen

1. Tab "Farm-Updates" öffnen
2. "Neues Update" klicken
3. Name und Image-Version eingeben
4. Hosts auswählen
5. Batch-Größe festlegen (z.B. 5 Hosts gleichzeitig)
6. Optional: Zeitfenster und Force-Logoff konfigurieren
7. Erstellen und Starten

### Update-Ablauf pro Host

1. **Drain** — Wartungsmodus aktivieren
2. **Migrate** — Aktive Sessions auf andere Hosts migrieren
3. **Warten** — Bis alle Sessions beendet sind
4. **Reboot** — Neustart mit neuem Golden Image
5. **Activate** — Wartungsmodus deaktivieren, Host nimmt Sessions an

### Steuerung

- **Pause** — Update anhalten (laufender Batch wird noch fertig)
- **Fortsetzen** — Pausiertes Update weiterführen
- Der Fortschritt wird live im Dashboard angezeigt

## Agent

Der PowerShell-Agent wird auf dem RD Connection Broker installiert:

```powershell
.\agent.ps1 -Install
```

Er meldet automatisch alle 5 Minuten:
- Host-Status (CPU, RAM, Disk, Sessions)
- Alle aktiven Sessions

Manuelle Befehle:
```powershell
.\agent.ps1 -Drain RDS-SRV01        # Wartungsmodus an
.\agent.ps1 -Activate RDS-SRV01     # Wartungsmodus aus
.\agent.ps1 -Reboot RDS-SRV01       # Host neustarten
.\agent.ps1 -Disconnect 1234        # Session trennen
.\agent.ps1 -Logoff 1234            # Session abmelden
.\agent.ps1 -MigrateSessions RDS01  # Alle Sessions migrieren
```

## Tipps

- Sessions werden bei Drain automatisch auf freie Hosts umgeleitet (5–15 Sek. Unterbrechung)
- Farm-Updates immer außerhalb der Kernarbeitszeit planen
- Drucker-Mappings regelmäßig prüfen wenn neue IP-Bereiche hinzukommen
- Der Agent braucht lokale Admin-Rechte auf dem Connection Broker