Applets de commande PowerShell (mode SharePoint de Reporting Services)

Lorsque vous installez le mode SharePoint de SQL Server 2012 Reporting Services, 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 SharePoint de Reporting Services.

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

• Gestion des fonctionnalités d'Reporting Services, par exemple extensions et clés de chiffrement.

Cette rubrique contient les sections suivantes :

• Cmdlet Summary

• Shared Service Cmdlets

• Service Application Cmdlets

• Reporting Services functionality related Cmdlets

• Basic Samples

• Detailed Samples

  • Create a service application and proxy

  • Review and update a delivery extension

  • Get and set Properties of the Reporting Service Application Database

  • List Data Extensions

  • Change and list subscription owners

Résumé des applets de commande

Pour exécuter les applets de commande, vous devez ouvrir SharePoint Management Shell. Vous pouvez également utiliser l'éditeur d'interface utilisateur graphique fourni avec Microsoft Windows, Environnement d'écriture de scripts intégré de Windows PowerShell (ISE). Pour plus d'informations, consultez Démarrage de Windows PowerShell sur Windows Server (https://technet.microsoft.com/library/hh847814.aspx). 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 en tant que 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 existe, 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'est pas installé et par conséquent, 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 commande de PowerShell. Exemple :

Get-Help Get-SPRSServiceApplicationServers

Top

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.

Top

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.

Top

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. Ce sera la liste complète des applets de commande de Reporting Services.

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

Installez le service Reporting Services SharePoint et le proxy de service.

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"

Top

Exemples détaillés

Outre les exemples suivants, consultez la section « Script Windows PowerShell » dans la rubrique (Steps 1-4) Windows PowerShell script for Steps 1–4.

Créer une application de service et 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 aux applications de service à la base de données de contenus de l'application Web sur le port 80. Le script suppose que le 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

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 nom du serveur SMTP (<email server name>) et 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. Exemple :

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

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 « My RS Service App ». 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 "My RS Service App"
Get-SPRSExtension -identity $app -ExtensionType "Delivery" -name "Report Server Email" | select -ExpandProperty ConfigurationXml

Top

Obtenir et définir les propriétés de la base de données d'application Reporting Services

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

Top

Répertorier des extensions de données

L'exemple suivant effectue une itération sur chaque application de service Reporting Services et répertorie 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

Top

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

Consultez Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription.

Top

Voir aussi

Concepts

Use PowerShell to Change and List Reporting Services Subscription Owners and Run a Subscription

Obtenir de l'aide sur SQL Server PowerShell

Autres ressources

Scripts PowerShell de gestion CodePlex SharePoint

Procédure : administrer SSRS à l'aide de PowerShell