Applets de commande PowerShell pour le mode SharePoint de Reporting Services

Lorsque vous installez SQL Server 2014 Reporting Services mode SharePoint, les applets de commande PowerShell sont installées pour prendre en charge les serveurs de rapports en mode SharePoint. Les applets de commande couvrent trois catégories de fonctionnalités.

• Installation du service partagé et du proxy Reporting Services SharePoint.

• Configuration et gestion des applications de service Reporting Services et des proxys associés.

• Gestion des fonctionnalités de Reporting Services, comme les extensions et les clés de chiffrement.

Cette rubrique contient les sections suivantes :

• Résumé de l’applet de commande

• Applets de commande de service partagé et de proxy

• Application de service et applets de commande proxy

• Reporting Services applets de commande de fonctionnalités personnalisées

• Exemples de base

• Exemples détaillés

  • Créer une application de service Reporting Services et un proxy

  • Passer en revue et mettre à jour une extension de remise de Reporting Services

  • Obtenir et définir les propriétés de la base de données d'application Reporting Services, par exemple le délai d'expiration de la base de données

  • Répertorier les extensions de données Reporting Services - Mode SharePoint

  • Modifier et répertorier les propriétaires d'abonnement

Résumé des applets de commande

Pour exécuter les applets de commande, vous devez ouvrir 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) . Pour plus d’informations, consultez Démarrage de Windows PowerShell sur 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. Cela inclut la configuration, la définition d'alertes et les bases de données temp.

Si vous voyez un message d'erreur semblable au suivant lorsque vous tapez les exemples PowerShell :

• Install-SPRSService : Le terme 'Install-SPRSService' n'est pas reconnu comme le
  nom d'applet de commande, fonction, fichier de script ou programme exécutable. Vérifiez l’orthographe du nom ou, si un chemin d’accès a été inclus, vérifiez que le chemin d’accès est correct et réessayez.

Un des problèmes suivants se produit :

• Le mode SharePoint de Reporting Services n’étant pas installé, les applets de commande Reporting Services ne sont pas installées.

• Vous avez exécuté la commande PowerShell dans Windows PowerShell ou Windows PowerShell ISE au lieu de 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 :

  Add-PSSnapin Microsoft.SharePoint.PowerShell  
  

Pour plus d’informations, consultez Utiliser Windows PowerShell pour administrer SharePoint 2013 (https://technet.microsoft.com/library/ee806878.aspx).

Pour ouvrir SharePoint Management Shell et exécuter les applets de commande

1. Cliquez sur le bouton Démarrer .

2. Cliquez sur le groupe Produits Microsoft SharePoint .

3. Cliquez sur 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 PowerShell. Par exemple :

Get-Help Get-SPRSServiceApplicationServers

Applets de commande de service partagé et de proxy

Le tableau suivant contient les applets de commande PowerShell pour le service partagé Reporting Services SharePoint.

Applets de commande d'application de service et de proxy

Le tableau suivant contient les applets de commande PowerShell pour les applications de service Reporting Services et leurs proxys associés.

Applets de commande personnalisés de la fonctionnalité « Reporting Services »

Exemples de base

Retournez la liste des applets de commande qui contiennent « SPRS » dans le nom. La liste complète des applets de commande Reporting Services sera retournée.

Get-command -noun *SPRS*  

Ou bien, vous serez redirigés vers un fichier texte nommé commandlist.txt contenant plus de détails.

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

Installer le service Reporting Services SharePoint et ses proxys.

Install-SPRSService  

Install-SPRSServiceProxy  

Démarrer le service Reporting Services

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. La commande filtre les lignes qui contiennent « ssrscustomactionerror ». Cet exemple consulte le fichier journal créé lorsque le fichier rssharepoint.msi a été installé.

Get-Content -Path C:\Users\testuser\AppData\Local\Temp\rs_sp_0.log | Select-String "ssrscustomactionerror"  

Exemples détaillés

Outre les exemples suivants, consultez la section « Script Windows PowerShell » dans la rubrique Script Windows PowerShell pour les étapes 1 à 4.

Création d'une application de service Reporting Services et d'un proxy

Cet exemple de script effectue les tâches suivantes :

1. Création d'une application de service Reporting Services et d'un proxy. Le script suppose que le pool d’applications « My App Pool » existe déjà.

2. Ajout du proxy au groupe de proxy par défaut

3. Octroi de l’accès à l’application de service à la base de données de contenu de l’application web sur le port 80. Le script suppose site "http://sitename" ; existe déjà.

# 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)

Analyse et mise à jour d'une extension de remise Reporting Services

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. Mettez à jour les valeurs du serveur SMTP (<email server name>) et de l’alias de messagerie électronique FROM (<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. Par exemple :

$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 ». 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 ».

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.

$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 :

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 Services, par exemple le délai d'expiration de la base de données

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. Pour obtenir une liste complète des propriétés, utilisez Get-SPRSDatabase | format-list.

Get-SPRSDatabase | Select id, querytimeout,connectiontimeout, status, server, ServiceInstance

Voici un exemple de sortie. Déterminez l'ID de la base de données que vous voulez modifier et utilisez l'ID de l'applet de commande SET.

• 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.

Get-SPRSDatabase -Identity 56f8d1bc-cb04-44cf-bd41-a873643c5a14 | Select id, querytimeout,connectiontimeout, status, server, ServiceInstance  

Répertorier les extensions de données Reporting Services - Mode SharePoint

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.

$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 :

• 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'abonnement

Consultez Utiliser PowerShell pour modifier et répertorier Reporting Services propriétaires d’abonnement et exécuter un abonnement.

Voir aussi

Utiliser PowerShell pour modifier et répertorier les propriétaires d’abonnements Reporting Services, et exécuter un abonnement
Liste de vérification : utiliser PowerShell pour vérifier PowerPivot pour SharePoint
Scripts PowerShell de gestion CodePlex SharePoint