Cmdlets de PowerShell para el modo de SharePoint de Reporting ServicesPowerShell cmdlets for Reporting Services SharePoint mode

SE APLICA A:APPLIES TO: síSQL Server Reporting Services (2016)SQL Server Reporting Services (2016) síSharePointSharePoint noPower BI Report ServerPower BI Report ServersíSQL Server Reporting Services (2016)SQL Server Reporting Services (2016) síSharePointSharePoint noPower BI Report ServerPower BI Report Server

Para obtener contenido relacionado con versiones anteriores de SQL Server Reporting Services (SSRS), vea SQL Server Reporting Services 2014.For content related to previous versions of SQL Server Reporting Services (SSRS), see SQL Server 2014 Reporting Services.

Al instalar SQL Server 2016 Reporting Services en modo de SharePoint, se instalan cmdlets de PowerShell para admitir servidores de informes en modo de SharePoint.When you install SQL Server 2016 Reporting Services SharePoint mode, PowerShell cmdlets are installed to support report Servers in SharePoint mode. Los cmdlets abarcan tres categorías de funcionalidad.The cmdlets cover three categories of functionality.

  • La instalación del proxy y el servicio compartido de SharePoint de Reporting Services.Installation of the Reporting Services SharePoint shared service and proxy.

  • El aprovisionamiento y la administración de las aplicaciones de servicio de Reporting Services y los servidores proxy asociados.Provisioning and management of Reporting Services service applications and associated proxies.

  • La administración de las características de Reporting Services, como las extensiones y las claves de cifrado.Management of Reporting Services features, for example extensions and encryption keys.

Nota

La integración de Reporting Services con SharePoint ya no está disponible a partir de SQL Server 2016.Reporting Services integration with SharePoint is no longer available after SQL Server 2016.

Resumen de los cmdletsCmdlet summary

Para ejecutar los cmdlets es necesario abrir el Shell de administración de SharePoint.To run the cmdlets you need to open the SharePoint Management Shell. También puede usar el editor de la interfaz gráfica de usuario incluido en Microsoft Windows, Entorno de scripting integrado (ISE) de Windows PowerShell.You can also use the graphical user interface editor that is included with Microsoft Windows, Windows PowerShell Integrated Scripting Environment (ISE). Para más información, vea Starting Windows PowerShell on Windows Server.For more information, see Starting Windows PowerShell on Windows Server. En los resúmenes de cmdlet siguientes, las referencias a la aplicación de servicio "databases" se aplican a todas las bases de datos creadas y usadas por una aplicación de servicio de 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. Esto incluye la configuración, la creación de alertas y las bases de datos temporales.This includes the configuration, alerting, and temp databases.

Si ve un mensaje de error similar al siguiente al escribir los ejemplos de PowerShell:If you see an error message similar to the following when you type the PowerShell examples:

  • Install-SPRSService : El término 'Install-SPRSService' no se reconoce comoInstall-SPRSService : The term 'Install-SPRSService' is not recognized as the
    nombre de un cmdlet, función, archivo de script o programa ejecutable.name of a cmdlet, function, script file, or operable program. Compruebe la ortografía del nombre o si una ruta de acceso se incluyó, compruebe que la ruta de acceso es correcta e inténtelo de nuevo.Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

Se está produciendo uno de los problemas siguientes:One of the following issues is occurring:

  • El modo de SharePoint de Reporting Services no está instalado y, por tanto, los cmdlets de Reporting Services tampoco.Reporting Services SharePoint mode is not installed and therefore the Reporting Services cmdlets are not installed.

  • Ejecutó el comando de PowerShell en Windows Powershell o Windows PowerShell ISE en lugar del Shell de administración de SharePoint.You ran the PowerShell command in Windows PowerShell or Windows PowerShell ISE instead of the SharePoint Management Shell. Use el Shell de administración de SharePoint o agregue el Complemento de SharePoint a la ventana de Windows PowerShell con el comando siguiente: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  
    

Para más información, vea Usar Windows PowerShell para administrar SharePoint 2013.For more information see Use Windows PowerShell to administer SharePoint 2013.

Abrir el Shell de administración de SharePoint y ejecutar cmdletsOpen the SharePoint Management Shell and run cmdlets

  1. Haga clic en el botón Inicio .Click the Start button

  2. Haga clic en el grupo Productos de Microsoft SharePoint .Click the Microsoft SharePoint Products group.

  3. Haga clic en Shell de administración de SharePoint.Click the SharePoint Management Shell.

Para ver la ayuda de la línea de comandos para un cmdlet, use el comando "Get-Help" de PowerShell en el símbolo del sistema de PowerShell.To view command line help for a cmdlet use the PowerShell 'Get-Help' command at the PowerShell command prompt. Por ejemplo:For example:

Get-Help Get-SPRSServiceApplicationServers

Cmdlets de servicios compartidos y servidores proxyShared service and proxy cmdlets

La tabla siguiente contiene los cmdlets de PowerShell para el servicio compartido de SharePoint de Reporting Services.The following table contains the PowerShell cmdlets for the Reporting Services SharePoint shared service.

CmdletCmdlet DescripciónDescription
Install-SPRSServiceInstall-SPRSService Instala o registra, o desinstala, el servicio compartido de Reporting Services.Installs and registers, or uninstalls, the Reporting Services shared service. Esto solo se puede hacer en el equipo que tiene una instalación de SQL Server Reporting Services en modo de SharePoint.This can be done only on the machine that has an installation of SQL Server Reporting Services in SharePoint mode. Para la instalación, se producen dos operaciones:For installation, two operations occur:

-El servicio de Reporting Services se instala en la granja de servidores.-The Reporting Services service is installed in the farm.

-La instancia del servicio de Reporting Services se instala en el equipo actual.-The Reporting Services service instance is installed to the current machine.

Para la desinstalación, se producen dos operaciones:For Uninstallation, two operations occur:

-El servicio de Reporting Services se desinstala del equipo actual.-The Reporting Services service is uninstalled from the current machine.

-El servicio de Reporting Services se desinstala de la granja de servidores.-The Reporting Services service is uninstalled from the farm.



Si hay otros equipos en la granja de servidores que tengan instalado el servicio de Reporting Services o si todavía hay aplicaciones de servicio de Reporting Services ejecutándose en ella, se muestra un mensaje de advertencia.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 Instala y registra, o desinstala, el proxy de servicio de Reporting Services en la granja de SharePoint.Installs and registers, or uninstalls, the Reporting Services service proxy in the SharePoint farm.
Get-SPRSProxyUrlGet-SPRSProxyUrl Obtiene las direcciones URL para obtener acceso al servicio de Reporting Services.Gets the URL(s) for accessing the Reporting Services service.
Get-SPRSServiceApplicationServersGet-SPRSServiceApplicationServers Obtiene todos los servidores de la granja de SharePoint que contienen una instalación del servicio compartido de Reporting Services.Gets all servers in the local SharePoint farm that contain an installation of the Reporting Services shared service. Este cmdlet es útil para las actualizaciones de Reporting Services, con el fin de determinar qué servidores ejecutan el servicio compartido y por tanto no es necesario actualizar.This cmdlet is useful for Reporting Services upgrades, to determine which servers run the shared service and therefore need to be upgraded.

Cmdlets de aplicaciones de servicio y servidores proxyService application and proxy cmdlets

La tabla siguiente contiene los cmdlets de PowerShell para las aplicaciones de servicio de Reporting Services y sus servidores proxy asociados.The following table contains the PowerShell cmdlets for Reporting Services service applications and their associated proxies.

cmdletcmdlet DescripciónDescription
Get-SPRSServiceApplicationGet-SPRSServiceApplication Obtiene uno o más objetos de aplicación de servicio de Reporting Services.Gets one or more Reporting Services service application objects.
New-SPRSServiceApplicationNew-SPRSServiceApplication Crea una nueva aplicación de servicio de Reporting Services y las bases de datos asociadas.Create a new Reporting Services service application and associated databases.

Parámetro LogonType: especifica si el servidor de informes utiliza la cuenta del grupo de aplicaciones SSRS o un inicio de sesión de SQL Server para tener acceso a la base de datos del servidor de informes.LogonType Parameter: Specifies if the report server uses the SSRS Application Pool account or a SQL Server login to access the report server database. Los valores válidos son:Valid values are:

0 Autenticación de Windows0 Windows Authentication

1 SQL Server1 SQL Server

2 Cuenta del grupo de aplicaciones (valor predeterminado)2 Application Pool Account (default)
Remove-SPRSServiceApplicationRemove-SPRSServiceApplication Quita la aplicación de servicio de Reporting Services especificada.Removes the specified Reporting Services service application. También se quitarán las bases de datos asociadas.This will also remove the associated databases.
Set-SPRSServiceApplicationSet-SPRSServiceApplication Edita las propiedades de una aplicación de servicio de Reporting Services existente.Edits the properties of an existing Reporting Services service application.
New-SPRSServiceApplicationProxyNew-SPRSServiceApplicationProxy Crea un nuevo proxy de aplicación de servicio de Reporting Services.Creates a new Reporting Services service application proxy.
Get-SPRSServiceApplicationProxyGet-SPRSServiceApplicationProxy Obtiene uno o más servidores proxy de aplicación de servicio de Reporting Services.Gets one or more Reporting Services service application proxies.
Dismount-SPRSDatabaseDismount-SPRSDatabase Desmonta las bases de datos de la aplicación de servicio de una aplicación de servicio de Reporting Services.Dismounts the service application databases for a Reporting Services service application.
Remove-SPRSDatabaseRemove-SPRSDatabase Quita las bases de datos de la aplicación de servicio de una aplicación de servicio de Reporting Services.Remove the service application databases for a Reporting Services service application.
Set-SPRSDatabaseSet-SPRSDatabase Establece las propiedades de las bases de datos asociadas a una aplicación de servicio de Reporting Services.Sets the properties of the databases associated to a Reporting Services service application.
Mount-SPRSDatabaseMount-SPRSDatabase Monta bases de datos para una aplicación de servicio de Reporting Services.Mounts databases for a Reporting Services service application.
New-SPRSDatabaseNew-SPRSDatabase Crea nuevas bases de datos de la aplicación de servicio para la aplicación de servicio de Reporting Services especificada.Create new service application databases for the specified Reporting Services service application.
Get-SPRSDatabaseCreationScriptGet-SPRSDatabaseCreationScript Envía el script de creación de base de datos a la pantalla de una aplicación de servicio de Reporting Services.Outputs the database creation script to the screen for a Reporting Services service application. Este script se puede ejecutar a continuación en SQL Server Management Studio.You can then run the script in SQL Server Management Studio.
Get-SPRSDatabaseGet-SPRSDatabase Obtiene una o más bases de datos de aplicación de servicio de Reporting Services.Gets one or more Reporting Services service application databases. Use el comando para obtener el identificador de la base de datos de la aplicación del servicio de forma que pueda usar el cmdlet Set-SPRSDatabase para modificar las propiedades, por ejemplo 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. Vea el ejemplo de este tema, Obtener y establecer las propiedades de la base de datos de aplicación de Reporting Services.See the example in this topic, Get and set Properties of the Reporting Service application database.
Get-SPRSDatabaseRightsScriptGet-SPRSDatabaseRightsScript Envía el script de derechos de base de datos a la pantalla de una aplicación de servicio de Reporting Services.Outputs the database rights script to the screen for a Reporting Services service application. Solicita el usuario y la base de datos, y luego devuelve Transact-SQL que se puede ejecutar para modificar los permisos.It will prompt for desired user and database then returns transact SQL you can run to modify permissions. Este script se puede ejecutar a continuación en SQL Server Management Studio.You can then run this script in SQL Server Management Studio.
Get-SPRSDatabaseUpgradeScriptGet-SPRSDatabaseUpgradeScript Muestra el script de actualización de bases de datos en la pantalla.Outputs a database upgrade script to the screen. El script actualiza las bases de datos de la aplicación de servicio de Reporting Services a la versión de base de datos de la instalación actual de Reporting Services.The script will upgrade Reporting Services service application databases to the database version of the current Reporting Services installation.

Cmdlets de funcionalidad personalizada de Reporting ServicesReporting Services custom functionality cmdlets

CmdletCmdlet DescripciónDescription
Update-SPRSEncryptionKeyUpdate-SPRSEncryptionKey Actualiza la clave de cifrado para la aplicación de servicio de Reporting Services especificada y cifra de nuevo sus datos.Updates the encryption key for the specified Reporting Services service application and re-encrypts its data.
Restore-SPRSEncryptionKeyRestore-SPRSEncryptionKey Restaura una clave de cifrado de la que se hizo copia de seguridad anteriormente para una aplicación de servicio de Reporting Services.Restores a previously backed up encryption key for a Reporting Services service application.
Remove-SPRSEncryptedDataRemove-SPRSEncryptedData Elimina los datos cifrados para la aplicación de servicio de Reporting Services especificada.Delete the encrypted data for the specified Reporting Services service application.
Backup-SPRSEncryptionKeyBackup-SPRSEncryptionKey Realiza una copia de seguridad de la clave de cifrado para la aplicación de servicio de Reporting Services especificada.Backs up the encryption key for the specified Reporting Services service application.
New-SPRSExtensionNew-SPRSExtension Registra una nueva extensión con una aplicación de servicio de Reporting Services.Registers a new extension with a Reporting Services service application.
Set-SPRSExtensionSet-SPRSExtension Establece las propiedades de una extensión de Reporting Services existente.Sets the properties of an existing Reporting Services extension.
Remove-SPRSExtensionRemove-SPRSExtension Quita una extensión de una aplicación de servicio de Reporting Services.Removes an extension from a Reporting Services service application.
Get-SPRSExtensionGet-SPRSExtension Obtiene una o más extensiones de Reporting Services para un aplicación de servicio de Reporting Services.Gets one or more Reporting Services extensions for a Reporting Services service application.

Los valores válidos son:Valid values are:



EntregaDelivery

DeliveryUIDeliveryUI

RenderRender

dataData

SeguridadSecurity

AutenticaciónAuthentication

EventProcessingEventProcessing

ReportItemsReportItems

DiseñadorDesigner

ReportItemDesignerReportItemDesigner

ReportItemConverterReportItemConverter

ReportDefinitionCustomizationReportDefinitionCustomization
Get-SPRSSiteGet-SPRSSite Obtiene los sitios de SharePoint basándose en si está habilitada la característica "ReportingService".Gets the SharePoint sites based on whether the "ReportingService" feature is enabled. De forma predeterminada, se devuelven los sitios que habilitan la característica "ReportingService".By default, sites that enable the "ReportingService" feature are returned.

Ejemplos básicosBasic samples

Devolver una lista de cmdlets cuyo nombre contiene "SPRS".Return a list of cmdlets that contain 'SPRS' in the name. Se trata de la lista completa de cmdlets de Reporting Services.This will be the full list of Reporting Services cmdlets.

Get-command -noun *SPRS*  

O con un poco más detalle, enviar la salida a un archivo de texto denominado commandlist.txtOr 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  

Instale el servicio y el proxy de servicio de SharePoint de Reporting Services.Install the Reporting Services SharePoint service and service proxy.

Install-SPRSService  
Install-SPRSServiceProxy  

Iniciar el servicio de Reporting ServicesStart the Reporting Services service

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

Escriba el siguiente comando desde el Shell de administración de SharePoint para devolver una lista filtrada de filas de un archivo de registro.Type the following command from the SharePoint Management Shell to return a filtered list of rows from the a log file. El comando filtrará las líneas que contengan "ssrscustomactionerror".The command will filter for lines that contain "ssrscustomactionerror". En este ejemplo se examina el archivo de registro creado cuando se instaló rssharepoint.msi.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"  

Ejemplos detalladosDetailed samples

Además de los ejemplos siguientes, vea la sección "Scripts de Windows PowerShell" en el tema Script de Windows PowerShell para los pasos 1 a 4.In addition to the following samples, see the section "Windows PowerShell Script" in the topic Windows PowerShell script for Steps 1-4.

Crear una aplicación de servicio de Reporting Services y un proxyCreate a reporting services service application and proxy

Este script de ejemplo realiza las tareas siguientes:This sample script completes the following tasks:

  1. Crea una aplicación de servicio de Reporting Services y un proxy.Create a Reporting Services service application and proxy. El script asume que el grupo de aplicaciones "My App Pool" ya existe.The script assumes the application pool "My App Pool" already exists.

  2. Agrega el proxy al grupo de servidores proxy predeterminado.Add the proxy to the default proxy group

  3. Concede acceso a la aplicación de servicio al puerto 80 de la base de datos de contenido de la aplicación web.Grant the service app access to the port 80 web app's content database. El script supone que el sitio https://sitename ya existe.The script assumes site https://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 "https://sitename"  
$appPoolAccountName = $appPool.ProcessAccount.LookupName()  
$webApp.GrantAccessToProcessIdentity($appPoolAccountName)  
  

Revisar y actualizar una extensión de entrega de Reporting ServicesReview and update a reporting services delivery extension

El siguiente ejemplo de script de PowerShell actualiza la configuración de la extensión de entrega de correo electrónico del servidor de informes para la aplicación de servicio denominada 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. Actualice los valores para el servidor SMTP (<email server name>) y el alias de correo electrónico 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  

En el ejemplo anterior, si no supiera el nombre exacto de la aplicación de servicio, podría reescribir la primera instrucción para obtener la aplicación de servicio a partir de una búsqueda del nombre parcial.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. Por ejemplo:For example:

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

El script siguiente devolverá los valores de configuración actual de la extensión de entrega por correo electrónico del servidor de informes para la aplicación de servicio denominada "Reporting Services Application".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". El primer paso establece el valor de la variable $app en el objeto de la aplicación de servicio denominada " 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 segunda instrucción obtendrá la extensión de entrega por correo electrónico del servidor de informes para el objeto de aplicación de servicio de la variable $app, y seleccionará el XML de configuración.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  

Asimismo, puede reescribir las dos instrucciones anteriores como una sola: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  

Obtener y establecer las propiedades de la base de datos de aplicación de Reporting ServicesGet and set properties of the Reporting Service application database

En el siguiente ejemplo, se obtiene, en primer lugar, una lista de las bases de datos y propiedades de forma que pueda determinar el GUID (identificador) de la base de datos que proporciona después al comando SET.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. Para obtener una lista completa de las propiedades, use 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   

A continuación se muestra un ejemplo del resultado.The following is an example of the output. Determine el identificador para la base de datos que desee modificar y use el identificador en el cmdlet 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  

Para comprobar que se ha establecido el valor, vuelva a ejecutar el cmdlet 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  

Enumerar extensiones de datos de Reporting ServicesList Reporting Services data extensions

El siguiente ejemplo recorre en bucle cada aplicación de servicio de Reporting Services y muestra las extensiones de datos actuales de cada una.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  
}  

Salida de ejemplo:Example output:

  • Name ExtensionType

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

    SQL Data

    SQLAZURE Data

    SQLPDW Data

    OLEDB Data

    OLEDB-MD Data

    ORACLE Data

    ODBC Data

    XML Data

    SHAREPOINTLIST Data

Cambiar y enumerar propietarios de suscripciones de Reporting ServicesChange and list Reporting Services subscription owners

Vea Uso de PowerShell para cambiar y enumerar a los propietarios de una suscripción de Reporting Services y ejecutar una suscripción.See Use PowerShell to change and list Reporting Services subscription owners and run a subscription.

Pasos siguientesNext steps

Uso de PowerShell para cambiar y enumerar a los propietarios de una suscripción de Reporting Services y ejecutar una suscripciónUse PowerShell to change and list Reporting Services subscription owners and run a subscription
Lista de comprobación: usar PowerShell para comprobar PowerPivot para SharePoint CheckList: Use PowerShell to verify Power Pivot for SharePoint
Obtener ayuda de SQL Server PowerShellGet help SQL Server PowerShell

¿Tiene alguna pregunta más?More questions? Puede plantear sus dudas en el foro de Reporting Services.Try asking the Reporting Services forum