Anwender-Handbuch
SSRS
WinForms
April 2025
Schritt für Schritt
SSRS Report Deployment Tool v3.0
Anwender-Handbuch – Reports, Datenquellen und Shared Datasets Schritt für Schritt auf den Report Server deployen.
1
Tool
starten
starten
2
Server
verbinden
verbinden
3
Zielordner
wählen
wählen
4
Quelldateien
scannen
scannen
5
Deployment
starten
starten
6
Ergebnis
prüfen
prüfen
Bevor es losgeht
①Voraussetzungen
| Was wird benötigt? | Details |
|---|---|
| PowerShell 5.1 | Vorinstalliert auf Windows Server 2016 und neuer |
| Berechtigungen auf dem Report Server | Mindestens Inhalts-Manager oder Publisher auf dem Zielordner |
| Netzwerkzugriff auf SSRS | HTTP-Erreichbarkeit des Report Servers (Standard: Port 80) |
| Quelldateien auf einem lokalen oder Netzwerkpfad | .rdl, .rds, .rsds oder .rsd Dateien |
Hinweis für Remote-Server: Bei Verbindung auf einen anderen Server als den lokalen
Rechner schlägt Windows-Authentifizierung wegen Kerberos Double-Hop fehl.
In diesem Fall manuelle Credentials verwenden (siehe Schritt 2).
Schritt 1 von 6
1Tool starten
1
PowerShell-Skript ausführen
Rechtsklick → „Mit PowerShell ausführen" oder Kommandozeile
Das Skript liegt als einzelne .ps1-Datei vor.
Am einfachsten starten per Rechtsklick → Mit PowerShell ausführen.
Alternativ über eine PowerShell-Konsole:
PS C:\Tools> powershell.exe -ExecutionPolicy Bypass -File ".\SSRS_DeployTool_v3.ps1"
Das Tool öffnet sich und sucht automatisch nach einem lokalen SSRS-Server. Das Log zeigt den Fortschritt:
Konfiguration
Report Server URL:
http://SRV-SQL01/Reports
Quellverzeichnis:
— noch nicht gesetzt —
Zielordner (Server):
— im Baum links auswählen —
Im Baum wählen
Authentifizierung:
Manuelle Credentials verwenden
Serverordner
Zuerst verbinden ...
Zuerst verbinden ...
Deployment-Log
[08:42:10] ──── SSRS Deployment Tool v3.0 bereit. ────
[08:42:10] [INFO] Benutzer: CONTOSO\m.mustermann
[08:42:11] [OK] Lokaler Report Server gefunden: http://SRV-SQL01/Reports
[08:42:11] [INFO] URL wurde vorbelegt – bitte Verbinden klicken.
[08:42:11] [INFO] 1. Server-URL 2. Verbinden 3. Ordner 4. Scannen 5. Deployen
[08:42:10] [INFO] Benutzer: CONTOSO\m.mustermann
[08:42:11] [OK] Lokaler Report Server gefunden: http://SRV-SQL01/Reports
[08:42:11] [INFO] URL wurde vorbelegt – bitte Verbinden klicken.
[08:42:11] [INFO] 1. Server-URL 2. Verbinden 3. Ordner 4. Scannen 5. Deployen
Abb. 1 – Startfenster: lokaler SSRS wurde automatisch gefunden (URL grün vorbelegt)
URL automatisch gefunden: Wenn das Log „Lokaler Report Server gefunden" anzeigt
und die URL grün hinterlegt ist, kann direkt mit Schritt 2 fortgefahren werden.
Kein Server gefunden? Das Log zeigt „Kein lokaler Report Server gefunden".
URL-Feld manuell ausfüllen, z. B.
http://reportserver/Reports.
Schritt 2 von 6
2Server verbinden
2
Verbindung zum Report Server herstellen
Windows-Auth oder manuelle Credentials
Variante A – Windows-Authentifizierung (Standard)
Wenn der Report Server im gleichen Active Directory erreichbar ist und der angemeldete Windows-Benutzer ausreichende SSRS-Rechte hat, genügt ein Klick auf Verbinden. Die Checkbox „Manuelle Credentials" bleibt deaktiviert.
Konfiguration
Report Server URL:
http://SRV-SQL01/Reports
Authentifizierung:
Manuelle Credentials verwenden
← deaktiviert lassen
Deployment-Log
[08:42:15] [OK] Verbunden: Microsoft SQL Server Reporting Services 2022 [http://SRV-SQL01/Reports]
[08:42:15] [OK] Ordnerstruktur geladen – 12 Ordner
[08:42:15] [OK] Ordnerstruktur geladen – 12 Ordner
Abb. 2a – Verbindung per Windows-Auth erfolgreich
Variante B – Manuelle Credentials
Bei Remote-Servern oder wenn der angemeldete Benutzer keine SSRS-Rechte hat:
Checkbox „Manuelle Credentials verwenden" aktivieren.
Benutzername im Format DOMAIN\Benutzer oder
Konfiguration
Report Server URL:
http://SRV-REPORT02/Reports
Authentifizierung:
Manuelle Credentials verwenden
← aktiviert
Benutzer:
CONTOSO\adm.deploy
Kennwort:
••••••••••
Abb. 2b – Manuelle Credentials für Remote-Server
Kennwort-Sicherheit: Das eingegebene Kennwort wird ausschließlich im
Arbeitsspeicher gehalten und beim Schließen des Tools verworfen.
Es wird nirgends gespeichert oder protokolliert.
Schritt 3 von 6
3Zielordner im Report Server wählen
3
Ordner im TreeView auswählen
Der gewählte Ordner wird als Deployment-Ziel übernommen
Nach erfolgreicher Verbindung zeigt der Serverordner-Baum die komplette Ordnerstruktur des Report Servers. Mit einem Klick auf den gewünschten Ordner wird er als Ziel übernommen – das Feld Zielordner (Server) aktualisiert sich sofort.
Konfiguration
Zielordner (Server):
/Berichte/Controlling/2025
Serverordner
📂 / (Wurzel)
📂 Berichte
📂 Controlling
📁 2025
📁 Vertrieb
📁 Archiv
📁 Datasets
📁 Datenquellen
📂 Berichte
📂 Controlling
📁 2025
📁 Vertrieb
📁 Archiv
📁 Datasets
📁 Datenquellen
12 Ordner
Deployment-Log
[08:42:16] [INFO] Zielordner: /Berichte/Controlling/2025
Abb. 3 – Ordner „/Berichte/Controlling/2025" ausgewählt (blau markiert)
Tipp: Der gewählte Zielordner gilt für alle ausgewählten Dateien des
aktuellen Deployments. Reports, Datenquellen und Datasets landen alle im selben Ordner.
Optional
+Neuen Ordner anlegen
+
Zielordner existiert noch nicht
Rechtsklick im TreeView → Neuen Ordner anlegen
Wenn der gewünschte Zielordner im Report Server noch nicht vorhanden ist, kann er direkt aus dem Tool heraus angelegt werden. Rechtsklick auf den übergeordneten Ordner im TreeView öffnet das Kontextmenü:
Serverordner
📂 / (Wurzel)
📂 Berichte
📁 Controlling 🖱️
📁 Vertrieb
📁 Datasets
📂 Berichte
📁 Controlling 🖱️
📁 Vertrieb
📁 Datasets
Neuen Ordner anlegen
✕
Neuer Ordner unter: /Berichte/Controlling
Abb. 4 – Kontextmenü und Ordner-Dialog: Neuer Unterordner „2025" unter /Berichte/Controlling
- Den gewünschten Ordnernamen eingeben (keine Schrägstriche oder Sonderzeichen)
- Klick auf Anlegen – der Ordner wird sofort per REST angelegt und im Baum angezeigt
- Der neue Ordner wird automatisch als Zielordner übernommen
Ungültige Zeichen: Ordnernamen dürfen keines dieser Zeichen enthalten:
/ \ < > : " | ? *
Schritt 4 von 6
4Quelldateien scannen
4
Quellverzeichnis wählen und scannen
Alle .rdl / .rds / .rsds / .rsd Dateien werden aufgelistet
Klick auf Durchsuchen öffnet einen Ordner-Auswahldialog. Nach Auswahl des Verzeichnisses mit Scannen alle Artefaktdateien einlesen. Alle gefundenen Dateien werden mit Checkbox vorausgewählt.
Konfiguration
Quellverzeichnis:
D:\Projekte\Controlling\SSRS_Deploy
Serverordner
📂 / (Wurzel)
📂 Berichte
📂 Controlling
📁 2025
📁 Vertrieb
📁 Datasets
📂 Berichte
📂 Controlling
📁 2025
📁 Vertrieb
📁 Datasets
12 Ordner
Gefundene Dateien
| ☑ | Datei | Typ | Größe | Geändert | Status |
|---|---|---|---|---|---|
| ☑ | Monatsbericht_2025.rdl | Report | 38,4 KB | 2025-04-28 | |
| ☑ | Jahresvergleich.rdl | Report | 52,1 KB | 2025-04-27 | |
| ☑ | KPI_Dashboard.rdl | Report | 21,8 KB | 2025-04-25 | |
| ☑ | DS_Controlling.rds | DSrc | 1,2 KB | 2025-01-10 | |
| ☑ | DS_DWH.rds | DSrc | 0,9 KB | 2025-01-10 |
Deployment-Log
[08:43:01] [INFO] Quellverzeichnis: D:\Projekte\Controlling\SSRS_Deploy
[08:43:01] [INFO] Scan: 5 Datei(en) – D:\Projekte\Controlling\SSRS_Deploy
[08:43:01] [INFO] Scan: 5 Datei(en) – D:\Projekte\Controlling\SSRS_Deploy
Abb. 5 – Nach Scan: 5 Dateien gefunden, alle vorausgewählt
Auswahl anpassen
- Alle – setzt alle Checkboxen auf angehakt
- Keine – setzt alle Checkboxen auf abgehakt
- Einzelne Dateien können individuell per Checkbox ein- oder ausgeschaltet werden
Datenquellen-Tipp: Bestehende Datenquellen (
.rds) werden beim
Deployment übersprungen, wenn sie bereits auf dem Server existieren.
Ihre Verbindungskonfiguration bleibt dabei vollständig erhalten.
Neue Datenquellen werden angelegt. Soll eine bestehende Datenquelle bewusst
überschrieben werden, muss sie vorher manuell im Report Server gelöscht werden.
Schritt 5 von 6
5Deployment ausführen
5
▶ Deployment starten
Der Button ist erst aktiv wenn Server, Zielordner und Dateien gewählt sind
Sobald alle drei Voraussetzungen erfüllt sind (Server verbunden, Zielordner gewählt, mindestens eine Datei angehakt), wird der ▶ Deployment starten-Button aktiv. Ein Klick startet den Vorgang.
Serverordner
📂 Berichte
📂 Controlling
📁 2025
📂 Controlling
📁 2025
Gefundene Dateien
| ☑ | Datei | Typ | Status |
|---|---|---|---|
| ☑ | Monatsbericht_2025.rdl | Report | UPDATED |
| ☑ | Jahresvergleich.rdl | Report | CREATED |
| ☑ | KPI_Dashboard.rdl | Report | ... |
| ☑ | DS_Controlling.rds | DSrc | |
| ☑ | DS_DWH.rds | DSrc |
Deployment-Log
[08:43:10] ──── Deploy → /Berichte/Controlling/2025 (5 Datei(en)) ────
[08:43:11] [OK] Monatsbericht_2025.rdl → UPDATED
[08:43:11] [OK] Jahresvergleich.rdl → CREATED
[08:43:12] [INFO] KPI_Dashboard.rdl wird verarbeitet ...
[08:43:11] [OK] Monatsbericht_2025.rdl → UPDATED
[08:43:11] [OK] Jahresvergleich.rdl → CREATED
[08:43:12] [INFO] KPI_Dashboard.rdl wird verarbeitet ...
Abb. 6 – Deployment läuft: ProgressBar zeigt Fortschritt, Status je Datei wird sofort eingetragen
Während des Deployments sind die Buttons Verbinden,
Scannen und Deployment starten deaktiviert.
Die GUI bleibt vollständig bedienbar – Scrollen im Log ist jederzeit möglich.
Schritt 6 von 6
6Ergebnis & Log prüfen
6
Zusammenfassung und Farbcodes
Jede Datei erhält einen Status-Eintrag im Log und in der Liste
Serverordner
📂 Berichte
📂 Controlling
📁 2025
📂 Controlling
📁 2025
Gefundene Dateien
| ☑ | Datei | Typ | Status |
|---|---|---|---|
| ☑ | Monatsbericht_2025.rdl | Report | UPDATED |
| ☑ | Jahresvergleich.rdl | Report | CREATED |
| ☑ | KPI_Dashboard.rdl | Report | UPDATED |
| ☑ | DS_Controlling.rds | DSrc | SKIPPED (bereits vorhanden) |
| ☑ | DS_DWH.rds | DSrc | SKIPPED (bereits vorhanden) |
Deployment-Log
[08:43:11] [OK] Monatsbericht_2025.rdl → UPDATED
[08:43:11] [OK] Jahresvergleich.rdl → CREATED
[08:43:12] [OK] KPI_Dashboard.rdl → UPDATED
[08:43:12] [SKIP] DS_Controlling.rds → SKIPPED (bereits vorhanden - Connection bleibt erhalten)
[08:43:12] [SKIP] DS_DWH.rds → SKIPPED (bereits vorhanden - Connection bleibt erhalten)
[08:43:12] ──── Abgeschlossen: 3 OK | 2 Übersprungen | 0 Fehler ────
[08:43:11] [OK] Jahresvergleich.rdl → CREATED
[08:43:12] [OK] KPI_Dashboard.rdl → UPDATED
[08:43:12] [SKIP] DS_Controlling.rds → SKIPPED (bereits vorhanden - Connection bleibt erhalten)
[08:43:12] [SKIP] DS_DWH.rds → SKIPPED (bereits vorhanden - Connection bleibt erhalten)
[08:43:12] ──── Abgeschlossen: 3 OK | 2 Übersprungen | 0 Fehler ────
Abb. 7 – Abgeschlossenes Deployment: 3 OK, 2 übersprungen, 0 Fehler
Bedeutung der Status-Farben
| Status | Farbe | Bedeutung |
|---|---|---|
| UPDATED | Grün | Datei war bereits vorhanden und wurde erfolgreich überschrieben |
| CREATED | Blau | Datei war neu und wurde erfolgreich angelegt |
| SKIPPED | Blaugrau | Datenquelle war bereits vorhanden – keine Aktion (Connection bleibt erhalten) |
| FEHLER | Rot | Deployment dieser Datei ist fehlgeschlagen – Details im Log |
Log speichern
Mit dem Button Log speichern unterhalb des Log-Fensters kann der
gesamte Deployment-Verlauf als .txt-Datei exportiert werden.
Der Dateiname enthält automatisch Datum und Uhrzeit.
Fehlerbehebung
!Häufige Fehler & Lösungen
!
Verbindungsfehler beim Klick auf „Verbinden"
Log: [FEHLER] Verbindungsfehler: ...
[08:42:20] [FEHLER] Verbindungsfehler: The remote server returned an error: (401) Unauthorized. | URI: http://SRV-REPORT02/Reports/api/v2.0/System
| Fehlermeldung enthält | Ursache | Lösung |
|---|---|---|
| (401) Unauthorized | Keine SSRS-Berechtigung mit aktuellem Benutzer | Manuelle Credentials mit einem Konto mit Publisher-Rechten verwenden |
| (404) Not Found | URL falsch – API-Pfad nicht gefunden | URL prüfen: muss auf /Reports oder /ReportServer enden |
| Unable to connect / Timeout | Report Server nicht erreichbar | Netzwerkverbindung und Firewall prüfen; SSRS-Dienst auf dem Server prüfen |
| The underlying connection was closed | HTTPS mit ungültigem Zertifikat | HTTP statt HTTPS verwenden oder Zertifikats-Ausnahme konfigurieren |
!
Deployment-Fehler bei einzelnen Dateien
Log: [FEHLER] Dateiname.rdl → FEHLER: ...
[08:43:14] [FEHLER] KPI_Dashboard.rdl → FEHLER: (403) Forbidden | URI: .../Reports/api/v2.0/Reports | Body: {"Name":"KPI_Dashboard",...}
| Fehlermeldung enthält | Ursache | Lösung |
|---|---|---|
| (403) Forbidden | Benutzer hat keine Schreibrechte auf dem Zielordner | SSRS-Berechtigungen auf dem Zielordner prüfen (mindestens Publisher) |
| (400) Bad Request | Ungültige RDL-Datei oder nicht unterstützte RDL-Version | Report im Report Designer öffnen und als aktuelle Version speichern |
| Path already used | Name-Konflikt im Zielordner | Selten – tritt auf wenn PATCH-Erkennung fehlschlägt; Datei manuell löschen und neu deployen |
Teilweise Fehler: Ein Fehler bei einer Datei bricht das gesamte Deployment
nicht ab. Alle anderen ausgewählten Dateien werden weiter verarbeitet.
Die Zusammenfassungszeile zeigt die genaue Anzahl von OK / Übersprungen / Fehlern.
⚠
Deployment-Button bleibt inaktiv (ausgegraut)
Der Button wird erst aktiv wenn alle drei Bedingungen erfüllt sind
| Bedingung | Prüfen |
|---|---|
| Server verbunden | Log zeigt „[OK] Verbunden: ..." – andernfalls Verbinden klicken |
| Zielordner gewählt | Feld „Zielordner (Server)" ist gefüllt – andernfalls im Baum einen Ordner anklicken |
| Mindestens eine Datei angehakt | ListView enthält mindestens einen angehakten Eintrag – andernfalls Scannen ausführen |
Kurzreferenz
✓Kurzreferenz
| Aktion | Wo | Hinweis |
|---|---|---|
| Tool starten | Rechtsklick auf .ps1 → Mit PowerShell ausführen | Lokaler SSRS wird automatisch gesucht |
| Server verbinden | URL-Feld + Button „Verbinden" | Windows-Auth oder manuelle Credentials |
| Zielordner wählen | Klick im TreeView links | Feld „Zielordner" aktualisiert sich automatisch |
| Neuen Ordner anlegen | Rechtsklick im TreeView → „Neuen Ordner anlegen" | Keine Sonderzeichen im Namen |
| Quellverzeichnis wählen | Button „Durchsuchen" | Nur eine Verzeichnisebene wird gescannt |
| Dateien scannen | Button „Scannen" | Alle .rdl/.rds/.rsds/.rsd werden gefunden |
| Auswahl anpassen | Checkboxen in der Liste / „Alle" / „Keine" | Nur angehakte Dateien werden deployed |
| Deployment starten | Button „▶ Deployment starten" | Erst aktiv wenn alle Bedingungen erfüllt |
| Log speichern | Button „Log speichern" unter dem Log | UTF-8 .txt mit Datum/Uhrzeit im Dateinamen |
| Log leeren | Button „Log leeren" | Nur Anzeige, keine Auswirkung auf Deployment |
Verhalten je Dateityp – Kurzfassung
| Dateityp | Vorhanden auf Server | Nicht vorhanden |
|---|---|---|
.rdl Report | UPDATED – wird überschrieben | CREATED – wird angelegt |
.rds / .rsds Datenquelle | SKIPPED – Connection bleibt erhalten | CREATED – wird angelegt |
.rsd Shared Dataset | UPDATED – wird überschrieben | CREATED – wird angelegt |