Applets de commande PowerShell pour le mode SharePoint de Reporting ServicesPowerShell cmdlets for Reporting Services SharePoint mode

CETTE RUBRIQUE S’APPLIQUE À :THIS TOPIC APPLIES TO: ouiSQL Server Reporting Services (2016)SQL Server Reporting Services (2016) ouiSharePointSharePoint nonPower BI Report ServerPower BI Report Server) ouiSQL Server Reporting Services (2016)SQL Server Reporting Services (2016) ouiSharePointSharePoint nonPower BI Report ServerPower BI Report Server

Pour obtenir du contenu pour les versions précédentes de SQL Server Reporting Services, consultez SQL Server Reporting Services 2014.For content related to previous versions of SQL Server Reporting Services, see SQL Server Reporting Services 2014.

Lorsque vous installez le mode SharePoint de SQL Server 2016 Reporting Services, les applets de commande PowerShell sont installées afin de prendre en charge les serveurs de rapports en mode SharePoint.When you install SQL Server 2016 Reporting Services SharePoint mode, PowerShell cmdlets are installed to support report Servers in SharePoint mode. Les applets de commande couvrent trois catégories de fonctionnalités.The cmdlets cover three categories of functionality.

  • Installation du service partagé et du proxy Reporting Services SharePoint.Installation of the Reporting Services SharePoint shared service and proxy.

  • Configuration et gestion des applications de service Reporting Services et des proxys associés.Provisioning and management of Reporting Services service applications and associated proxies.

  • Gestion des fonctionnalités de Reporting Services, comme les extensions et les clés de chiffrement.Management of Reporting Services features, for example extensions and encryption keys.

Note

L’intégration de Reporting Services à SharePoint n’est plus disponible après SQL Server 2016.Reporting Services integration with SharePoint is no longer available after SQL Server 2016.

Résumé des applets de commandeCmdlet summary

Pour exécuter les applets de commande, vous devez ouvrir SharePoint Management Shell.To run the cmdlets you need to open the SharePoint Management Shell. Vous pouvez aussi utiliser l’éditeur d’interface utilisateur graphique fourni avec Microsoft Windows : l’Environnement d’écriture de scripts intégré de Windows PowerShell (ISE).You can also use the graphical user interface editor that is included with Microsoft Windows, Windows PowerShell Integrated Scripting Environment (ISE). Pour plus d’informations, consultez Démarrage de Windows PowerShell sur Windows Server.For more information, see Starting Windows PowerShell on Windows Server. Dans les résumés suivants d’applets de commande, les références à l’application de service « bases de données » font référence à toutes les bases de données créées et utilisées par une application de service Reporting Services.In the following cmdlet summaries, the references to service application ‘databases’, refer to all of the databases created and used by a Reporting Services service application. Cela inclut la configuration, la définition d'alertes et les bases de données temp.This includes the configuration, alerting, and temp databases.

Si vous voyez un message d'erreur semblable au suivant lorsque vous tapez les exemples PowerShell :If you see an error message similar to the following when you type the PowerShell examples:

  • Install-SPRSService : Le terme 'Install-SPRSService' n'est pas reconnu commeInstall-SPRSService : The term 'Install-SPRSService' is not recognized as the
    nom d'applet de commande, fonction, fichier de script ou programme exécutable.name of a cmdlet, function, script file, or operable program. Vérifiez l'orthographe du nom, ou si un chemin d'accès existe, vérifiez que le chemin d'accès est correct et réessayez.Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

    Un des problèmes suivants se produit :One of the following issues is occurring:

  • Le mode SharePoint de Reporting Services n’étant pas installé, les applets de commande Reporting Services ne sont pas installées.Reporting Services SharePoint mode is not installed and therefore the Reporting Services cmdlets are not installed.

  • Vous avez exécuté la commande PowerShell dans Windows PowerShell ou Windows PowerShell ISE au lieu de SharePoint Management Shell.You ran the PowerShell command in Windows PowerShell or Windows PowerShell ISE instead of the SharePoint Management Shell. Utilisez SharePoint Management Shell ou ajoutez le composant logiciel enfichable SharePoint à la fenêtre Windows PowerShell à l'aide de la commande suivante :Use the SharePoint Management shell or add the SharePoint Snap-in to the Windows PowerShell window with the following command:

    Add-PSSnapin Microsoft.SharePoint.PowerShell  
    

    Pour plus d’informations, consultez Utiliser Windows PowerShell pour administrer SharePoint 2013.For more information see Use Windows PowerShell to administer SharePoint 2013.

Pour ouvrir SharePoint Management Shell et exécuter les applets de commandeOpen the SharePoint Management Shell and run cmdlets

  1. Cliquez sur le bouton Démarrer .Click the Start button

  2. Cliquez sur le groupe Produits Microsoft SharePoint .Click the Microsoft SharePoint Products group.

  3. Cliquez sur SharePoint Management Shell.Click the SharePoint Management Shell.

    Pour consulter l'aide sur la ligne de commande pour une applet de commande utilisez la commande « GET-HELP » de PowerShell à l'invite de commandes de PowerShell.To view command line help for a cmdlet use the PowerShell ‘Get-Help’ command at the PowerShell command prompt. Exemple :For example:

    Get-Help Get-SPRSServiceApplicationServers

Applets de commande de service partagé et de proxyShared service and proxy cmdlets

Le tableau suivant contient les applets de commande PowerShell pour le service partagé Reporting Services SharePoint.The following table contains the PowerShell cmdlets for the Reporting Services SharePoint shared service.

Applet de commandeCmdlet DescriptionDescription
Install-SPRSServiceInstall-SPRSService Installe et enregistre, ou désinstalle, le service partagé Reporting Services.Installs and registers, or uninstalls, the Reporting Services shared service. Cela peut être effectué uniquement sur l’ordinateur où SQL Server Reporting Services en mode SharePoint est installé.This can be done only on the machine that has an installation of SQL Server Reporting Services in SharePoint mode. Pour l'installation, deux opérations ont lieu :For installation, two operations occur:

- Le service Reporting Services est installé dans la batterie de serveurs.-The Reporting Services service is installed in the farm.

- L’instance du service Reporting Services est installée sur l’ordinateur actuel.-The Reporting Services service instance is installed to the current machine.

Pour la désinstallation, deux opérations ont lieu :For Uninstallation, two operations occur:

- Le service Reporting Services est désinstallé de l’ordinateur actuel.-The Reporting Services service is uninstalled from the current machine.

- Le service Reporting Services est désinstallé de la batterie de serveurs.-The Reporting Services service is uninstalled from the farm.



Si le service Reporting Services est installé sur d’autres ordinateurs de la batterie de serveurs ou si des applications de service Reporting Services sont encore en cours d’exécution dans la batterie, un message d’avertissement s’affiche.If there are any other machines in the farm that have the Reporting Services service installed, or if there are still Reporting Services service applications running in the farm, a warning message is displayed.
Install-SPRSServiceProxyInstall-SPRSServiceProxy Installe et enregistre, ou désinstalle, le proxy du service Reporting Services dans la batterie de serveurs SharePoint.Installs and registers, or uninstalls, the Reporting Services service proxy in the SharePoint farm.
Get-SPRSProxyUrlGet-SPRSProxyUrl Obtient la ou les URL d'accès au service Reporting Services.Gets the URL(s) for accessing the Reporting Services service.
Get-SPRSServiceApplicationServersGet-SPRSServiceApplicationServers Obtient tous les serveurs dans la batterie SharePoint locale qui contiennent une installation du service partagé Reporting Services.Gets all servers in the local SharePoint farm that contain an installation of the Reporting Services shared service. Cette applet de commande est utile pour les mises à niveau de Reporting Services car elle permet de déterminer quels serveurs exécutent le service partagé et doivent, par conséquent, être mis à niveau.This cmdlet is useful for Reporting Services upgrades, to determine which servers run the shared service and therefore need to be upgraded.

Applets de commande d’application de service et de proxyService application and proxy cmdlets

Le tableau suivant contient les applets de commande PowerShell pour les applications de service Reporting Services et leurs proxys associés.The following table contains the PowerShell cmdlets for Reporting Services service applications and their associated proxies.

Applet de commandecmdlet DescriptionDescription
Get-SPRSServiceApplicationGet-SPRSServiceApplication Obtient un ou plusieurs objets d’application de service Reporting Services.Gets one or more Reporting Services service application objects.
New-SPRSServiceApplicationNew-SPRSServiceApplication Crée une application de service Reporting Services et des bases de données associées.Create a new Reporting Services service application and associated databases.

Paramètre LogonType : spécifie si le serveur de rapports utilise le compte de pool d'applications SSRS ou un compte de connexion SQL Server pour accéder à la base de données du serveur de rapports.LogonType Parameter: Specifies if the report server uses the SSRS Application Pool account or a SQL Server login to access the report server database. Les valeurs valides sont :Valid values are:

0 Authentification Windows0 Windows Authentication

1 SQL Server1 SQL Server

2. Compte du pool d'applications (valeur par défaut)2 Application Pool Account (default)
Remove-SPRSServiceApplicationRemove-SPRSServiceApplication Supprime l'application de service Reporting Services spécifiée.Removes the specified Reporting Services service application. Cela supprimera également les bases de données associées.This will also remove the associated databases.
Set-SPRSServiceApplicationSet-SPRSServiceApplication Modifie les propriétés d'une base de données d'application de service Reporting Services existante.Edits the properties of an existing Reporting Services service application.
New-SPRSServiceApplicationProxyNew-SPRSServiceApplicationProxy Crée un nouveau proxy d'application de service Reporting Services.Creates a new Reporting Services service application proxy.
Get-SPRSServiceApplicationProxyGet-SPRSServiceApplicationProxy Obtient un ou plusieurs proxys d'application de service Reporting Services existante.Gets one or more Reporting Services service application proxies.
Dismount-SPRSDatabaseDismount-SPRSDatabase Démonte les bases de données d’une application de service Reporting Services.Dismounts the service application databases for a Reporting Services service application.
Remove-SPRSDatabaseRemove-SPRSDatabase Supprime les bases de données d’une application de service Reporting Services.Remove the service application databases for a Reporting Services service application.
Set-SPRSDatabaseSet-SPRSDatabase Définit les propriétés des bases de données associées à une application de service Reporting Services.Sets the properties of the databases associated to a Reporting Services service application.
Mount-SPRSDatabaseMount-SPRSDatabase Monte les bases de données d’une application de service Reporting Services.Mounts databases for a Reporting Services service application.
New-SPRSDatabaseNew-SPRSDatabase Crée de nouvelles bases de données pour l’application de service Reporting Services spécifiée.Create new service application databases for the specified Reporting Services service application.
Get-SPRSDatabaseCreationScriptGet-SPRSDatabaseCreationScript Affiche à l’écran le script de création de base de données pour une application de service Reporting Services.Outputs the database creation script to the screen for a Reporting Services service application. Vous pouvez ensuite exécuter le script dans SQL Server Management Studio.You can then run the script in SQL Server Management Studio.
Get-SPRSDatabaseGet-SPRSDatabase Obtient une ou plusieurs bases de données d'application de service Reporting Services.Gets one or more Reporting Services service application databases. Utilisez la commande pour obtenir l'ID de la base de données d'application de service afin d'utiliser l'applet de commande Set-SPRSDatabase pour modifier les propriétés, par exemple querytimeout.Use the command to get the ID of service application database so you can use the Set-SPRSDatabase comdlet to modify properties, for example the querytimeout. Consultez l’exemple de cette rubrique, Propriétés Get et Set de la base de données d’application Reporting Service.See the example in this topic, Get and set Properties of the Reporting Service application database.
Get-SPRSDatabaseRightsScriptGet-SPRSDatabaseRightsScript Affiche à l’écran le script de droits de base de données pour une application de service Reporting Services.Outputs the database rights script to the screen for a Reporting Services service application. Invite à entrer l'utilisateur et la base de données souhaités, puis retourne un script Transact-SQL que vous pouvez exécuter pour modifier des autorisations.It will prompt for desired user and database then returns transact SQL you can run to modify permissions. Vous pouvez ensuite exécuter ce script dans SQL Server Management Studio.You can then run this script in SQL Server Management Studio.
Get-SPRSDatabaseUpgradeScriptGet-SPRSDatabaseUpgradeScript Génère un script de mise à niveau de base de données à l'écran.Outputs a database upgrade script to the screen. Le script met à niveau les bases de données de l’application de service Reporting Services vers la version de base de données de l’installation actuelle de Reporting Services.The script will upgrade Reporting Services service application databases to the database version of the current Reporting Services installation.

Applets de commande personnalisés de Reporting ServicesReporting Services custom runctionality cmdlets

Applet de commandeCmdlet DescriptionDescription
Update-SPRSEncryptionKeyUpdate-SPRSEncryptionKey Met à jour la clé de chiffrement de l'application de service Reporting Services spécifiée et re-chiffre ses données.Updates the encryption key for the specified Reporting Services service application and re-encrypts its data.
Restore-SPRSEncryptionKeyRestore-SPRSEncryptionKey Restaure une clé de chiffrement précédemment sauvegardée pour une application de service Reporting Services.Restores a previously backed up encryption key for a Reporting Services service application.
Remove-SPRSEncryptedDataRemove-SPRSEncryptedData Supprime les données chiffrées de l'application de service Reporting Services spécifiée.Delete the encrypted data for the specified Reporting Services service application.
Backup-SPRSEncryptionKeyBackup-SPRSEncryptionKey Sauvegarde la clé de chiffrement de l'application de service Reporting Services spécifiée.Backs up the encryption key for the specified Reporting Services service application.
New-SPRSExtensionNew-SPRSExtension Enregistre une nouvelle extension avec une application de service Reporting Services.Registers a new extension with a Reporting Services service application.
Set-SPRSExtensionSet-SPRSExtension Définit les propriétés d'une extension Reporting Services existante.Sets the properties of an existing Reporting Services extension.
Remove-SPRSExtensionRemove-SPRSExtension Supprime une extension d'une application de service Reporting Services.Removes an extension from a Reporting Services service application.
Get-SPRSExtensionGet-SPRSExtension Obtient une ou plusieurs extensions Reporting Services pour une application de service Reporting Services.Gets one or more Reporting Services extensions for a Reporting Services service application.

Les valeurs valides sont :Valid values are:



RemiseDelivery

DeliveryUIDeliveryUI

RenderRender

DonnéesData

SécuritéSecurity

AuthentificationAuthentication

EventProcessingEventProcessing

ReportItemsReportItems

ConcepteurDesigner

ReportItemDesignerReportItemDesigner

ReportItemConverterReportItemConverter

ReportDefinitionCustomizationReportDefinitionCustomization
Get-SPRSSiteGet-SPRSSite Obtient les sites SharePoint en fonction de l'activation de la fonction « ReportingService ».Gets the SharePoint sites based on whether the "ReportingService" feature is enabled. Par défaut, les sites qui activent la fonction « ReportingService » sont retournés.By default, sites that enable the "ReportingService" feature are returned.

Exemples de baseBasic samples

Retournez la liste des applets de commande qui contiennent « SPRS » dans le nom.Return a list of cmdlets that contain ‘SPRS’ in the name. La liste complète des applets de commande Reporting Services sera retournée.This will be the full list of Reporting Services cmdlets.

Get-command –noun *SPRS*  

Ou bien, vous serez redirigés vers un fichier texte nommé commandlist.txt contenant plus de détails.Or with a little more detail, piped to a text file named commandlist.txt

Get-command -noun *SPRS* | Select name, definition | Format-List | Out-File c:\commandlist.txt  

Installer le service Reporting Services SharePoint et ses proxys.Install the Reporting Services SharePoint service and service proxy.

Install-SPRSService  
Install-SPRSServiceProxy  

Démarrer le service Reporting ServicesStart the Reporting Services service

get-spserviceinstance -all |where {$_.TypeName -like "SQL Server Reporting*"} | Start-SPServiceInstance  

Tapez la commande suivante à partir de SharePoint Management Shell pour retourner une liste filtrée des lignes du fichier journal.Type the following command from the SharePoint Management Shell to return a filtered list of rows from the a log file. La commande filtre les lignes qui contiennent « ssrscustomactionerror ».The command will filter for lines that contain “ssrscustomactionerror”. Cet exemple consulte le fichier journal créé lorsque le fichier rssharepoint.msi a été installé.This example is looking at the log file created when the rssharepoint.msi was installed.

Get-content -path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | select-string "ssrscustomactionerror"  

Exemples détaillésDetailed samples

Outre les exemples suivants, consultez la section « Script Windows PowerShell » dans la rubrique Windows PowerShell script for Steps 1–4.In addition to the following samples, see the section “Windows PowerShell Script” in the topic Windows PowerShell script for Steps 1–4.

Créer une application de service Reporting Services et un proxyCreate a reporting services service application and proxy

Cet exemple de script effectue les tâches suivantes :This sample script completes the following tasks:

  1. Création d'une application de service Reporting Services et d'un proxy.Create a Reporting Services service application and proxy. Le script suppose que le pool d'applications « My App Pool » existe déjà.The script assumes the application pool “My App Pool” already exists.

  2. Ajout du proxy au groupe de proxy par défautAdd the proxy to the default proxy group

  3. Octroi de l'accès aux applications de service à la base de données de contenus de l'application Web sur le port 80.Grant the service app access to the port 80 web app’s content database. Le script considère que le site http://sitename existe déjà.The script assumes site http://sitename already exists.

# Create service application and service application proxy  
$appPool = Get-SPServiceApplicationPool “My App Pool”  
$serviceApp = New-SPRSServiceApplication “My RS Service App” –ApplicationPool $appPool  
$serviceAppProxy = New-SPRSServiceApplicationProxy –Name “My RS Service App Proxy” –ServiceApplication $serviceApp  

# Add service application proxy to default proxy group.  Any web application that uses the default proxy group will now be able to use this service application.  
Get-SPServiceApplicationProxyGroup –default | Add-SPServiceApplicationProxyGroupMember –Member $serviceAppProxy  

# Grant application pool account access to the port 80 web application’s content database.  
$webApp = Get-SPWebApplication “http://sitename”  
$appPoolAccountName = $appPool.ProcessAccount.LookupName()  
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)  

Examiner et mettre à jour une extension de remise Reporting ServicesReview and update a reporting services delivery extension

L’exemple de script PowerShell suivant met à jour la configuration de l’extension de remise du courrier électronique par le serveur de rapports pour l’application de service nommée My RS Service App.The following PowerShell script example, updates the configuration for the report server e-mail delivery extension for the service application named My RS Service App. Mettez à jour les valeurs du serveur SMTP (<email server name>) et de l’alias de messagerie électronique FROM (<your FROM email address>).Update the values for the SMTP server (<email server name>) and the FROM email alias (<your FROM email address>).

$app=get-sprsserviceapplication -Name "My RS Service App"  
$emailCfg = Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml   
$emailXml = [xml]$emailCfg   
$emailXml.SelectSingleNode("//SMTPServer").InnerText = “<email server name>”  
$emailXml.SelectSingleNode("//SendUsing").InnerText = "2"  
$emailXml.SelectSingleNode("//SMTPAuthenticate").InnerText = "2"  
$emailXml.SelectSingleNode("//From").InnerText = '<your FROM email address>'  
Set-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" -ExtensionConfiguration $emailXml.OuterXml  

Dans l'exemple ci-dessus, si vous ne connaissiez pas le nom exact de l'application de service, vous pouvez réécrire la première instruction pour obtenir l'application de service en fonction d'une recherche portant sur son nom partiel.In the above example if you did not know the exact name of the service application, you could rewrite the first statement to get the service application based on a search of the partial name. Par exemple :For example:

$app=get-sprsserviceapplication | where {$_.name -like " ssrs_testapp *"}  

Le script suivant retourne les valeurs de configuration actuelles pour l'extension de remise de courrier électronique du serveur de rapports pour l'application de service nommée « Application Reporting Services ».The following script will return the current configuration values for the report server e-mail delivery extension for the service application named “Reporting Services Application”. La première étape définit la valeur de la variable $app pour l'objet de l'application de service dont le nom est « My RS Service App ».The first step sets the value of the variable $app to the object of the service application that has a name of " My RS Service App "

La deuxième instruction obtiendra l'extension de remise « Report Server Email » pour l'objet d'application de service dans la variable $app, puis sélectionne le configuration XML.The second statement will Get the ‘Report Server Email’ delivery extension for the service application object in variable $app, and select the configurationXML

$app=get-sprsserviceapplication –Name "Reporting Services Application"  
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml  

Vous pouvez réécrire les deux instructions ci-dessus dans une seule :You can also rewrite the above two statements as one:

get-sprsserviceapplication –Name "Reporting Services Application" | Get-SPRSExtension -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml  

Obtenir et définir les propriétés de la base de données d’application Reporting ServicesGet and set properties of the Reporting Service application database

L'exemple suivant renvoie d'abord une liste des bases de données et propriétés afin de déterminer le guid (ID) de base de données que vous fournissez à la commande.The following example first returns a list of the databases and properties so you can determine the database guid (ID) that you then supply to the set command. Pour obtenir une liste complète des propriétés, utilisez Get-SPRSDatabase | format-list.For a full list of the properties, use Get-SPRSDatabase | format-list.

get-SPRSDatabase | select id, querytimeout,connectiontimeout, status, server, ServiceInstance   

Voici un exemple de sortie.The following is an example of the output. Déterminez l'ID de la base de données que vous voulez modifier et utilisez l'ID de l'applet de commande SET.Determine the ID for the database you want to modify and use the ID in the SET cmdlet.

  • Id : 56f8d1bc-cb04-44cf-bd41-a873643c5a14

    QueryTimeout : 120

    ConnectionTimeout : 15

    Status : Online

    Server : SPServer Name=uetestb01

    ServiceInstance : SPDatabaseServiceInstance

Set-SPRSDatabase –identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 -QueryTimeout 300  

Pour vérifier que la valeur est définie, réexécutez l'applet de commande GET.To verify the value is set, run the GET cmdlet again.

Get-SPRSDatabase –identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 | select id, querytimeout,connectiontimeout, status, server, ServiceInstance  

Répertorier les extensions de données Reporting ServicesList Reporting Services data extensions

L’exemple suivant effectue une itération sur chaque application de service Reporting Services et répertorie pour chacune les extensions de données actuelles.The following example loops through each Reporting Services service application and lists the current data extensions for each.

$apps = Get-SPRSServiceApplication  
foreach ($app in $apps)   
{  
Write-host -ForegroundColor "yellow" Service App Name $app.Name  
Get-SPRSExtension -identity $app -ExtensionType “Data” | select name,extensiontype | Format-Table -AutoSize  
}  

Exemple de sortie :Example output:

  • Name ExtensionType

    ---- -------------

    SQL Data

    SQLAZURE Data

    SQLPDW Data

    OLEDB Data

    OLEDB-MD Data

    ORACLE Data

    ODBC Data

    XML Data

    SHAREPOINTLIST Data

Modifier et répertorier les propriétaires d’abonnements Reporting ServicesChange and list Reporting Services subscription owners

Consultez Utiliser PowerShell pour modifier et répertorier les propriétaires d’abonnements Reporting Services et exécuter un abonnement.See Use PowerShell to change and list Reporting Services subscription owners and run a subscription.

Étapes suivantesNext steps

Utiliser PowerShell pour modifier et répertorier les propriétaires d’abonnements Reporting Services et exécuter un abonnementUse PowerShell to change and list Reporting Services subscription owners and run a subscription
Liste de vérification : utiliser PowerShell pour vérifier Power Pivot pour SharePoint CheckList: Use PowerShell to verify Power Pivot for SharePoint
Obtenir de l’aide sur SQL Server PowerShellGet help SQL Server PowerShell

D’autres questions ?More questions? Essayez de poser une question dans le forum Reporting ServicesTry asking the Reporting Services forum