SSRS Report Deployment Tool v3.0
Anwender-Handbuch – Reports, Datenquellen und Shared Datasets Schritt für Schritt auf den Report Server deployen.
starten
verbinden
wählen
scannen
starten
prüfen
①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 |
1Tool starten
Das Skript liegt als einzelne .ps1-Datei vor.
Am einfachsten starten per Rechtsklick → Mit PowerShell ausführen.
Alternativ über eine PowerShell-Konsole:
Das Tool öffnet sich und sucht automatisch nach einem lokalen SSRS-Server. Das Log zeigt den Fortschritt:
[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
http://reportserver/Reports.
2Server verbinden
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.
[08:42:15] [OK] Ordnerstruktur geladen – 12 Ordner
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
3Zielordner im Report Server wählen
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.
📂 Berichte
📂 Controlling
📁 2025
📁 Vertrieb
📁 Archiv
📁 Datasets
📁 Datenquellen
+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ü:
📂 Berichte
📁 Controlling 🖱️
📁 Vertrieb
📁 Datasets
- 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
/ \ < > : " | ? *
4Quelldateien scannen
Klick auf Durchsuchen öffnet einen Ordner-Auswahldialog. Nach Auswahl des Verzeichnisses mit Scannen alle Artefaktdateien einlesen. Alle gefundenen Dateien werden mit Checkbox vorausgewählt.
📂 Berichte
📂 Controlling
📁 2025
📁 Vertrieb
📁 Datasets
| ☑ | 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 |
[08:43:01] [INFO] Scan: 5 Datei(en) – D:\Projekte\Controlling\SSRS_Deploy
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
.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.
5Deployment ausführen
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.
📂 Controlling
📁 2025
| ☑ | Datei | Typ | Status |
|---|---|---|---|
| ☑ | Monatsbericht_2025.rdl | Report | UPDATED |
| ☑ | Jahresvergleich.rdl | Report | CREATED |
| ☑ | KPI_Dashboard.rdl | Report | ... |
| ☑ | DS_Controlling.rds | DSrc | |
| ☑ | DS_DWH.rds | DSrc |
[08:43:11] [OK] Monatsbericht_2025.rdl → UPDATED
[08:43:11] [OK] Jahresvergleich.rdl → CREATED
[08:43:12] [INFO] KPI_Dashboard.rdl wird verarbeitet ...
6Ergebnis & Log prüfen
📂 Controlling
📁 2025
| ☑ | 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) |
[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 ────
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.
!Häufige Fehler & Lösungen
| 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 |
| 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 |
| 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
| 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 |
ReportServerCheck
Was Sie schon immer wissen wollten
Von Nutzungsstatistiken bis zu Sicherheitslücken – diese Fragen bleiben oft unbeantwortet. ReportServerCheck macht Schluss mit manueller Suche.
Vollständiges Inventar aller Berichte, inklusive versteckter Testversionen und Duplikate.
Caching, Timeouts, Authentifizierung – alle Systemeinstellungen auf einen Blick.
Zugriffshäufigkeiten, Spitzenlasten und historische Trends.
Fehlerprotokolle, Timeouts und abgebrochene Ausführungen – proaktiv erkennen.
Nutzer‑ und Gruppenaktivität, auch für interne Leistungsverrechnung.
Sicherheitsanalyse: Wer hat Zugriff auf sensible Finanz- oder Personaldaten?
Die meistgenutzten Berichte – Grundlage für Performance‑Tuning und Priorisierung.
„Datenleichen“ identifizieren, Katalog bereinigen, Übersichtlichkeit steigern.
All diese Informationen schlummern in der ReportServer-Datenbank. Bisher mussten Sie manuelle SQL-Abfragen, PowerShell-Skripte oder komplexe Excel-Listen bemühen – mühsam, statisch und ohne historische Verläufe. Mit ReportServerCheck erhalten Sie ein fertiges, durchdachtes Reporting‑Paket, das die Metadaten in aussagekräftige Berichte verwandelt.
Vorgefertigte Berichte, die Ihnen sofort ein umfassendes Cockpit für Ihre Reporting‑Landschaft bieten.
- Transparenz über Nutzung & Auslastung – inklusive der Top‑Reports und Fehlerquoten.
- Sicherheits‑Governance – Berechtigungsmatrix, Gruppen‑Audit, inaktive Nutzer.
- Konfigurations‑Snapshot – Systemeinstellungen, Abonnements, Zeitpläne.
- Bereinigungspotenzial – Liste aller seit X Monaten nicht ausgeführten Berichte.
Governance, die selbst berichtet
Gerade in Konzernen oder Behörden mit Hunderten von Berichten wächst die Komplexität schleichend. ReportServerCheck liefert nicht nur Momentaufnahmen, sondern erlaubt es, die Entwicklung über Wochen und Monate zu verfolgen. Identifizieren Sie Performance‑Engpässe, bevor Anwender sich beschweren. Erkennen Sie überflüssige Berechtigungen und halten Sie Compliance‑Anforderungen ein. Und das Beste: All dies wird als strukturierter, druckfähiger Report ausgegeben – denn gute Governance sollte sichtbar sein.
Bereit für klare Sicht?
Passen Sie die Datenquelle an – der Rest geschieht automatisch.