Scriptimplementatie en beheertaken

Reporting Services ondersteunt het gebruik van scripts voor het automatiseren van routine-installatie, implementatie en beheertaken. Het implementeren van een rapportserver is een proces met meerdere stappen. U moet verschillende hulpprogramma's en processen gebruiken om een implementatie te configureren; er is geen enkel programma of één benadering die kan worden gebruikt om alle taken te automatiseren.

Niet elke stap moet worden geautomatiseerd. In sommige gevallen is het handmatig uitvoeren van een stap of via een grafisch hulpprogramma de eenvoudigste en meest effectieve benadering. Als u bijvoorbeeld een groot aantal rapporten en modellen wilt implementeren, is het beter om de rapportserverdatabases te kopiëren in plaats van code te schrijven waarmee de rapportserveromgeving opnieuw wordt gemaakt.

Voor sommige stappen is aangepaste code vereist. Het configureren van de URL's voor de webservice en Report Manager kan bijvoorbeeld worden geautomatiseerd, maar alleen als u aangepaste code schrijft die aanroept naar de WMI-provider (Report Server Windows Management Instrumentation). Als u geen code wilt schrijven, moet u het hulpprogramma Reporting Services-configuratie gebruiken om de stap uit te voeren.

Als u een script wilt uitvoeren waarmee een rapportserver wordt geconfigureerd, moet u een lokale beheerder zijn op de computer die u configureert. Zie Een rapportserver configureren voor extern beheer voor meer informatie.

In dit artikel worden aanbevolen benaderingen beschreven voor het automatiseren van specifieke stappen. Er worden verschillende programma's en programmatische interfaces genoemd; beschrijvingen van elke beschrijving worden verderop in dit artikel gegeven.

Implementatietaken en hoe u deze automatiseert

De volgende tabel bevat een overzicht van de installatie- en configuratietaken die nodig zijn voor het implementeren van een rapportserver. U kunt de tabel gebruiken om een specifieke taak te koppelen aan een benadering waarmee u de taak zonder toezicht kunt automatiseren of uitvoeren.

Opdracht	Methode
Installeer Reporting Services.	U kunt het installatieprogramma uitvoeren vanuit de opdrachtprompt om een installatie zonder tussenkomst uit te voeren. U kunt Setup gebruiken om zowel een rapportserver te installeren als te configureren, maar alleen als u de standaardconfiguratieoptie opgeeft en uw systeem voldoet aan alle vereisten voor dit installatietype. Als u de standaardconfiguratie niet kunt installeren, moet u alleen bestanden installeren.
Configureer het serviceaccount.	Het serviceaccount wordt in eerste instantie geconfigureerd via Setup. Als u wijzigingen in het serviceaccount wilt automatiseren als een taak na de installatie, moet u aangepaste code schrijven die aanroept naar de WMI-provider van de rapportserver. Er zijn geen opdrachtpromptprogramma's of scriptsjablonen voor het programmatisch configureren van het serviceaccount. Als coderingsvereisten verhinderen dat u deze stap automatiseert, kunt u het account eenvoudig handmatig configureren door het hulpprogramma Reporting Services-configuratie uit te voeren. Zie Een serviceaccount configureren (Report Server Configuration Manager) voor meer informatie.
Configureer de Report Server-webservice en de URL's van de Report Manager.	U moet aangepaste code schrijven die aanroepen uitvoert naar de WMI-provider van de rapportserver. Er zijn geen opdrachtregelprogramma's of scriptsjablonen voor het configureren van de URL's. Als u wilt voorkomen dat u code schrijft, kunt u de URL's handmatig configureren door het hulpprogramma Reporting Services-configuratie uit te voeren. Zie Een URL configureren (Report Server Configuration Manager) voor meer informatie.
Maak de rapportserverdatabase.	U moet aangepaste code schrijven die aanroepen uitvoert naar de WMI-provider van de rapportserver. Er zijn geen opdrachtpromptprogramma's of scriptsjablonen voor het maken van de rapportserverdatabases en RSExecRole. Als u wilt voorkomen dat u code schrijft, kunt u de database handmatig maken door het hulpprogramma Reporting Services-configuratie uit te voeren. Zie Een rapportserverdatabase in de systeemeigen modus maken (Report Server Configuration Manager) voor meer informatie.
Configureer de databaseverbinding van de rapportserver.	Als u de verbindingsreeks, het account of wachtwoord of het verificatietype wijzigt, voert u het hulpprogramma rsconfig uit om de verbinding te configureren. Zie Een rapportserverdatabaseverbinding (Report Server Configuration Manager) en rsconfig Utility (SSRS) configureren voor meer informatie. U kunt rsconfig.exe niet gebruiken om de database te maken of bij te werken. De database en RSExecRole moeten al bestaan.
Configureer een uitschaalimplementatie.	Kies uit de volgende benaderingen om de uitschaalimplementatie te automatiseren: - Voer het hulpprogramma rskeymgmt.exe uit om rapportserverexemplaren toe te voegen aan een bestaande installatie. Zie Versleutelingssleutels toevoegen en verwijderen voor uitschaalimplementatie (Report Server Configuration Manager) voor meer informatie. - Schrijf aangepaste code die wordt uitgevoerd op de WMI-provider van de rapportserver.
Backup-encryptiesleutels.	Kies uit de volgende methoden om back-ups van versleutelingssleutels te automatiseren: - Voer het hulpprogramma rskeymgmt.exe uit om een back-up van de sleutels te maken. Zie Back-up maken en herstellen van Reporting Services-versleutelingssleutels voor meer informatie. - Schrijf aangepaste code die wordt uitgevoerd op de WMI-provider van de rapportserver.
E-mail van rapportserver configureren.	Schrijf aangepaste code die draait op de WMI-provider van Reporting Services. De provider ondersteunt een subset van de configuratie-instellingen voor e-mail. Hoewel het RSReportServer.config bestand alle instellingen bevat, gebruikt u het bestand niet op een geautomatiseerde manier. Gebruik met name geen batchbestand om het bestand naar een andere rapportserver te kopiëren. Elk configuratiebestand bevat waarden die specifiek zijn voor het huidige exemplaar. Deze waarden zijn niet geldig op andere exemplaren van de rapportserver. Zie E-mailinstellingen - systeemeigen Modus van Reporting Services (Configuration Manager) voor meer informatie over de instellingen.
Configureer het uitvoeringsaccount zonder toezicht.	Kies uit de volgende methoden om de configuratie van het account zonder toezicht te automatiseren: - Voer het hulpprogramma rsconfig.exe uit om het account te configureren. Zie Het account voor uitvoering zonder toezicht configureren (Report Server Configuration Manager) voor meer informatie. - Schrijf aangepaste code die aanroepen uitvoert naar de WMI-provider van de rapportserver.
Implementeer bestaande inhoud op een andere rapportserver, onder meer de mappenhiërarchie, roltoewijzingen, rapportages, abonnementen, planningen, gegevensbronnen en hulpmiddelen.	De beste manier om een bestaande rapportserveromgeving opnieuw te maken, is door de rapportserverdatabase te kopiëren naar een nieuw exemplaar van de rapportserver. Een alternatieve methode is het schrijven van aangepaste code waarmee bestaande inhoud van de rapportserver programmatisch opnieuw wordt gemaakt. Abonnementen, rapportmomentopnamen en rapportgeschiedenis kunnen echter niet programmatisch opnieuw worden gemaakt. Sommige implementaties kunnen voordeel hebben door beide technieken samen te gebruiken. Herstel bijvoorbeeld een rapportserverdatabase en voer vervolgens aangepaste code uit waarmee de rapportserverdatabase voor een specifieke installatie wordt gewijzigd. Zie Voorbeeld van Reporting Services rs.exe script voor het kopiëren van inhoud tussen rapportservers voor een gedetailleerd voorbeeld. Zie De rapportserverdatabases verplaatsen naar een andere computer (systeemeigen SSRS-modus) voor meer informatie over het verplaatsen van een rapportserverdatabase. Zie de sectie Scripts gebruiken om inhoud en mappen van de rapportserver te migreren in dit artikel voor meer informatie over het programmatisch maken van een rapportserveromgeving.

Hulpprogramma's en technologieën voor het automatiseren van serverimplementatie

De volgende lijst bevat een overzicht van de programma's en interfaces die kunnen worden gebruikt voor het automatiseren van implementatie- en onderhoudstaken:

Het installatieprogramma kan worden uitgevoerd in de modus zonder toezicht om onderdelen van de rapportserver te installeren en soms te configureren. U moet de Files-Only installatieoptie gebruiken om Setup te configureren voor een rapportserverexemplaar.
De WMI-provider van Reporting Services en de opdrachtregelprogramma's van Reporting Services kunnen worden gebruikt voor de configuratie van lokale en externe servers.

De WMI-provider van Reporting Services bevat klassen, eigenschappen en methoden waarmee u alle aspecten van een Reporting Services-installatie kunt configureren. Deze aspecten omvatten het opgeven van het serviceaccount en het configureren van URL's. Het kan ook gaan om het maken en configureren van de rapportserverdatabase of het configureren van een rapportserver voor e-mailbezorging. U moet aangepaste code of script schrijven om de WMI-provider te kunnen gebruiken. Zie Toegang tot de WMI-provider van Reporting Services voor meer informatie.

Een alternatief voor het schrijven van code is het gebruik van de opdrachtregelprogramma's (rsconfig.exe en rskeymgmt.exe). U kunt batchbestanden schrijven waarop de hulpprogramma's worden uitgevoerd. U kunt de hulpprogramma's gebruiken om sommige, maar niet alle configuratietaken te automatiseren.
Het scripthostprogramma van de rapportserver (rs.exe) kan aangepaste Microsoft Visual Basic-code uitvoeren, die u kunt schrijven om bestaande inhoud opnieuw te maken of van de ene rapportserver naar de andere te verplaatsen. Met deze methode schrijft u een script in Visual Basic, slaat u het op als een .rss-bestand en gebruikt rs.exe u het script op de doelrapportserver. Het script dat u schrijft, kan de SOAP-interface aanroepen naar de Report Server-webservice. Implementatiescripts worden geschreven met behulp van deze methode, omdat u hiermee een naamruimte en inhoud van de rapportservermap opnieuw kunt maken en op rollen gebaseerde beveiliging opnieuw kunt maken.
In de sql Server 2012-release zijn PowerShell-cmdlets geïntroduceerd voor de geïntegreerde modus van SharePoint. U kunt PowerShell gebruiken om de SharePoint-integratie te configureren en te beheren. Zie PowerShell-cmdlets voor de Reporting Services SharePoint-modus voor meer informatie.

Scripts gebruiken om inhoud en mappen van de rapportserver te migreren

U kunt scripts schrijven die een rapportserveromgeving dupliceren op een ander exemplaar van de rapportserver. Implementatiescripts worden geschreven in Visual Basic en vervolgens verwerkt met behulp van het scripthosthulpprogramma van de rapportserver.

Zie Voorbeeld van Reporting Services rs.exe script voor het kopiëren van inhoud tussen rapportservers voor een gedetailleerd voorbeeld.

Gebruik scripts om mappen, gedeelde gegevensbronnen, resources, rapporten, roltoewijzingen en instellingen van de ene server naar de andere te kopiëren. U schrijft een script voor één rapportserverexemplaar en voert het vervolgens uit op een andere server, waarmee u de naamruimte van de rapportserver opnieuw creëert. Als u meerdere rapportservers in uw Reporting Services-implementatie hebt, kunt u het script afzonderlijk op elke server uitvoeren om alle servers op dezelfde manier te configureren.

In de volgende lijst worden de stappen beschreven voor het migreren van rapporten van de ene server naar de andere.

Stel de scriptvariabele in op de URL van de bronrapportserver.
Gebruik de GetItemDefinition en GetProperties methoden om de rapportdefinitie en de eigenschappen van het rapport op te halen.
Stel de URL in om naar de doelserver te verwijzen.
Gebruik de CreateCatalogItem methode, met de eigenschappen geretourneerd door GetProperties en de rapportdefinitie die door GetItemDefinition wordt geretourneerd.

Met behulp van een combinatie van get- en create-methoden kunt u vergelijkbare stappen uitvoeren om instellingen, mappen, gedeelde gegevensbronnen en resources te migreren. Zie Technische naslaginformatie (SSRS) voor meer informatie over de methoden die voor u beschikbaar zijn.

Opmerking

Scripts worden uitgevoerd onder de Microsoft Windows-referenties van de gebruiker die het script uitvoert, tenzij referenties expliciet zijn ingesteld.

Zie Script met het hulpprogramma rs.exe en de webservice voor meer informatie over het opmaken en uitvoeren van een scriptbestand.

Scripts gebruiken om servereigenschappen in te stellen

U kunt scripts schrijven waarmee systeemeigenschappen op de rapportserver worden ingesteld. In het volgende Visual Basic .NET-script ziet u één manier om eigenschappen in te stellen. In dit voorbeeld wordt het besturingselement RSClientPrint ActiveX uitgeschakeld, maar u kunt EnableClientPrinting en False vervangen door een geldige eigenschapsnaam en waarde. Als u een volledige lijst met servereigenschappen wilt weergeven, raadpleegt u de systeemeigenschappen van de rapportserver.

Als u het script wilt gebruiken, slaat u het op in een bestand met de extensie .rss en gebruikt u vervolgens het rs.exe opdrachtpromptprogramma om het bestand uit te voeren op de rapportserver. Het script is niet gecompileerd, dus het is niet nodig om een installatie van Visual Basic te hebben. In dit voorbeeld wordt ervan uitgegaan dat u machtigingen hebt op de lokale computer die als host fungeert voor de rapportserver. Als u niet bent aangemeld onder een account met machtigingen, moet u accountgegevens opgeven via andere opdrachtregelargumenten. Zie RS.exe hulpprogramma (SSRS) voor meer informatie.

Aanbeveling

Zie Voorbeeld van Reporting Services rs.exe script voor het kopiëren van inhoud tussen rapportservers voor een gedetailleerd voorbeeld.

Public Sub Main()  
        Dim props(0) As [Property]  
        Dim setProp As New [Property]  
        setProp.Name = "EnableClientPrinting"  
        setProp.Value = "False"   
        props(0) = setProp  
        Try  
            rs.SetSystemProperties(props)  
        Catch ex As System.Web.Services.Protocols.SoapException  
            Console.Write(ex.Detail.InnerXml)  
        Catch e as Exception  
            Console.Write(e.Message)  
        End Try  
End Sub

Feedback

Is deze pagina nuttig?

Last updated on 2026-01-23