Analysis Services PowerShell

SQL Server 2012 Analysis Services (SSAS) incluye cmdlets y un proveedor de Analysis Services PowerShell (SQLAS) que permite usar Windows PowerShell para navegar, administrar y consultar objetos de Analysis Services.

Analysis Services PowerShell consta de:

• Un proveedor de SQLAS que se usa para navegar por la jerarquía de Objetos de administración de análisis (AMO).

• El cmdlet Invoke-ASCmd que se utiliza para ejecutar script XMLA, MDX o DMX.

• Cmdlets específicos de la tarea para ejecuciones rutinarias, como el procesamiento, la administración de roles, la administración de particiones, las copias de seguridad y la restauración.

En este artículo

Requisitos previos

Versiones admitidas y modos de Analysis Services

Requisitos de autenticación y consideraciones de seguridad

Tareas de Analysis Services PowerShell

Para obtener más información acerca de la sintaxis y los ejemplos, vea Referencia de Analysis Services PowerShell.

Requisitos previos

Windows PowerShell 2.0 debe estar instalado. Se instaló de forma predeterminada en las versiones más recientes de los sistemas operativos Windows. Para obtener más información, vea Instalar Windows PowerShell 2.0.

Debe instalar una característica de SQL Server que incluya el módulo SQL Server PowerShell (SQLPS) y las bibliotecas de cliente. La manera más fácil de hacerlo es instalar SQL Server Management Studio, que incluye automáticamente la característica PowerShell y las bibliotecas de cliente. El módulo SQL Server PowerShell (SQLPS) contiene los proveedores y cmdlets de PowerShell para todas las características de SQL Server, incluido el módulo SQLASCmdlets y el proveedor SQLAS utilizados para navegar por la jerarquía de objetos de Analysis Services.

Debe importar el módulo SQLPS para poder usar el proveedor y los cmdlets de SQLAS. El proveedor SQLAS es una extensión del proveedor SQLServer. Hay varias maneras de importar el módulo SQLPS. Para obtener más información, vea Importar el módulo SQLPS.

El acceso remoto a una instancia de Analysis Services requiere que habilite la administración remota y el uso compartido de archivos. Para obtener más información, vea Enable Remote Administration en este tema.

Versiones admitidas y modos de Analysis Services

Actualmente, Analysis Services PowerShell se admite en cualquier edición de SQL Server 2012 Analysis Services que se ejecuta en Windows Server 2008 R2, Windows Server 2008 SP1 o Windows 7.

En la tabla siguiente es muestra la disponibilidad de Analysis Services PowerShell en varios contextos.

Requisitos de autenticación y consideraciones de seguridad

Al conectarse a Analysis Services, debe realizar la conexión utilizando una identidad de usuario de Windows. En su mayor parte, una conexión se realiza utilizando la seguridad integrada de Windows, donde la identidad del usuario actual establece el contexto de seguridad en el que se realizan las operaciones de servidor. Sin embargo, están disponibles métodos de autenticación adicionales cuando se configura el acceso a Analysis Services a través de HTTP. En esta sección se explica cómo el tipo de conexión determina qué opciones de autenticación se pueden usar.

Las conexiones a Analysis Services se caracterizan como conexiones nativas o conexiones HTTP. Una conexión nativa es una conexión directa de una aplicación cliente con el servidor. En una sesión de PowerShell, el cliente de PowerShell utiliza el proveedor OLE DB para la conexión directa de Analysis Services con una instancia de Analysis Services. Una conexión nativa se realiza siempre utilizando la seguridad integrada de Windows, donde Analysis Services PowerShell se ejecuta como el usuario actual. Analysis Services no admite la suplantación. Si desea realizar una operación como un usuario específico, debe iniciar la sesión de PowerShell como ese usuario.

Las conexiones HTTP se realizan indirectamente a través de IIS, permitiendo opciones adicionales de autenticación, como la autenticación básica, para conectarse a una instancia de Analysis Services. Como IIS admite la suplantación, se puede proporcionar una cadena de conexión que incluya credenciales que IIS utilizará para realizar la suplantación cuando se realice una conexión. Para proporcionar credenciales, puede utilizar el parámetro –Credential.

Utilizar el parámetro –Credential en PowerShell

El parámetro –Credential toma un objeto PSCredential que especifica un nombre de usuario y una contraseña. En Analysis Services PowerShell, el parámetro –Credential está disponible para los cmdlets que realizan una solicitud de conexión a Analysis Services, en oposición a los cmdlets que se ejecutan dentro del contexto de una conexión existente. Entre los cmdlets que realizan una solicitud de conexión se hallan Invoke-ASCmd, Backup-ASDatabase y Restore-ASDatabase. Para estos cmdlets, se puede utilizar el parámetro –Credential en el supuesto de que se cumplan los criterios siguientes:

1. El servidor se configura para el acceso a través de HTTP, lo que significa que IIS administra la conexión, lee el nombre de usuario y la contraseña, y suplanta la identidad del usuario al conectarse a Analysis Services. Para obtener más información, vea Configurar el acceso HTTP a Analysis Services en Internet Information Services (IIS) 7.0.

2. El directorio virtual de IIS creado para el acceso a Analysis Services a través de HTTP se configura para la autenticación básica.

3. El nombre de usuario y la contraseña proporcionados por el objeto de credencial se resuelve como una identidad de usuario de Windows. Analysis Services utiliza esta identidad como usuario actual. Si el usuario no es un usuario de Windows, o carece de los permisos suficientes para realizar la operación solicitada, la solicitud dará un error.

Para crear un objeto de credencial, puede utilizar el cmdlet Get-Credential para recopilar las credenciales del operador. A continuación, puede utilizar el objeto de credencial en un comando que realiza la conexión a Analysis Services. En el ejemplo siguiente se muestra un enfoque. En este ejemplo, la conexión se realiza a una instancia local configurada para el acceso a través de HTTP.

PS SQLSERVER:\SQLAS\HTTP_DS> $cred = Get-credential adventureworks\dbadmin
PS SQLSERVER:\SQLAS\HTTP_DS> Invoke-ASCmd –Inputfile:”c:\discoverconnections.xmla” –Credential:$cred

Cuando se utiliza la autenticación básica, debe utilizar siempre HTTPS con SSL para que el nombre de usuario y las contraseñas se envíen mediante una conexión cifrada. Para obtener más información, vea Configurar la capa de sockets seguros en IIS 7 y Configurar la autenticación básica (IIS 7).

Recuerde que las credenciales, las consultas, y los comandos que se proporcionan en PowerShell se pasan sin cambiar a la capa de transporte. La inclusión de contenido confidencial en los scripts aumenta el riesgo de un ataque malintencionado por inyección.

Proporcionar una contraseña como un objeto Microsoft.Secure.String

Algunas operaciones, como copias de seguridad y restauración, admiten opciones de cifrado que se activan al proporcionar una contraseña en el comando. La acción de proporcionar la contraseña indica a Analysis Services que se ha de cifrar o descifrar el archivo de copia de seguridad. En Analysis Services, se crea una instancia de esta contraseña como un objeto de cadena seguro. En el ejemplo siguiente se proporciona una ilustración de cómo se recopila una contraseña del operador en tiempo de ejecución.

PS SQLSERVER:\SQLAS\Localhost\default> $pwd = read-host -AsSecureString -Prompt "Password"
Password: ****
PS SQLSERVER:\SQLAS\Localhost\default> $pwd -is [System.IDisposable] 
True

Ahora puede realizar una operación de copia de seguridad o de restauración en un archivo de base de datos cifrado pasando la variable $pwd al parámetro de contraseña. Para ver un ejemplo completo que combina esta ilustración con otros cmdlets, vea Cmdlet Backup-ASDatabase y Cmdlet Restore-ASDatabase.

Como paso de seguimiento, quite de la sesión tanto la contraseña como la variable.

PS SQLSERVER:\SQLAS\Localhost\default> $pwd.Dispose()
PS SQLSERVER:\SQLAS\Localhost\default> Remove-Variable -Name pwd

Tareas de Analysis Services PowerShell

Puede ejecutar Analysis Services PowerShell desde el shell de administración de Windows PowerShell o desde un símbolo del sistema de Windows. No se admite la ejecución de Analysis Services PowerShell desde SQL Server Management Studio.

En esta sección se describen las tareas comunes para utilizar Analysis Services PowerShell.

• Cargar los cmdlets y el proveedor de Analysis Services

• Habilitar la administración remota y el uso compartido de archivos

• Conectarse a un objeto de Analysis Services

• Administrar el servicio

• Obtener Ayuda para Analysis Services PowerShell

Cargar los cmdlets y el proveedor de Analysis Services

El proveedor de Analysis Services es una extensión del proveedor raíz de SQL Server que está disponible al importar el módulo SQLPS. Los cmdlets de Analysis Services se cargan simultáneamente; también puede cargarlos de modo independiente si desea utilizarlos con el proveedor.

• Ejecute el cmdlet del módulo Import para cargar el SQLPS que incluye toda la funcionalidad de Analysis Services PowerShell. Si no puede importar el módulo, puede cambiar temporalmente la directiva de ejecución a unrestricted con el fin de cargar el módulo. Para obtener más información, vea Importar el módulo SQLPS.

  Import-module “sqlps”
  

  O bien, use import-module “sqlps” –disablenamechecking para quitar la advertencia sobre los nombres de verbo no aprobados.

• Para cargar solo los cmdlets de Analysis Services específicos de la tarea, sin el proveedor de Analysis Services o el cmdlet Invoke-ASCmd, puede cargar el módulo SQLASCmdlets como una operación independiente.

  Import-module “sqlascmdlets”
  

Habilitar la administración remota

Para poder utilizar Analysis Services PowerShell con una instancia remota de Analysis Services, primero debe habilitar la administración remota y el uso compartido de archivos. El siguiente error indica un problema de configuración del firewall: “El servidor RPC no está disponible. (Excepción de HRESULT: 0x800706BA)”.

1. Compruebe que el equipo local y los equipos remotos tienen las versiones de SQL Server 2012 Analysis Services (SSAS) de las herramientas de servidor y de cliente.

2. En el servidor remoto que hospeda una instancia de Analysis Services, abra el puerto TCP 2383 en Firewall de Windows. Si instaló Analysis Services como una instancia con nombre o con un puerto personalizado, el número de puerto será diferente. Para obtener más información, vea Configurar Firewall de Windows para permitir el acceso a Analysis Services.

3. En el servidor remoto, compruebe que los siguientes servicios se han iniciado: servicio Llamada a procedimiento remoto (RPC), servicio de aplicación auxiliar NetBIOS TCP/IP, servicio Instrumental de administración de Windows (WMI), Servicio de administración remota de Windows (WS-Management).

4. En el servidor remoto, inicie el complemento Editor de objetos de directiva de grupo (gpedit.msc).

5. Abra sucesivamente Configuración del equipo, Plantillas administrativas, Red, Conexiones de red,Firewall de Windows y, por último, Perfil de dominio.

6. Haga doble clic en Firewall de Windows: permitir excepción de administración remota entrante, seleccione Habilitado y haga clic en Aceptar.

7. Haga doble clic en Firewall de Windows: permitir excepción Compartir archivos e impresoras entrante, seleccione Habilitado y haga clic en Aceptar.

8. En el equipo local que tiene las herramientas cliente, use los cmdlets siguientes para comprobar la administración remota, sustituyendo el nombre de servidor real por el marcador de posición remote-server-name. Omita el nombre de instancia si Analysis Services se instala como la instancia predeterminada. Debe haber importado previamente el módulo SQLPS para que el comando funcione.

   PS SQLSERVER:\> cd sqlas
   PS SQLSERVER:\sqlas> cd <remote-server-name\instance-name>
   PS SQLSERVER:\sqlas\<remote-server-name\instance-name> dir
   

En algunos casos, es posible que sea necesaria una configuración adicional. Puede que tenga que escribir lo siguiente en el servidor remoto para poderle emitir comandos desde otro equipo:

Enable-psremoting

Para obtener más información sobre la administración remota, vea About_remote_requirements.

Conectarse a un objeto de Analysis Services

El proveedor de Analysis Services PowerShell admite la navegación de la jerarquía de objetos de Analysis Services y establece el contexto para los comandos en ejecución. El proveedor es una extensión del proveedor raíz de SQLSERVER disponible a través del módulo SQLPS. Después de cargar el módulo SQLPS, puede navegar por la ruta de acceso.

Puede conectarse a una instancia local o remota, pero algunos cmdlets solo se pueden ejecutar en una instancia local (a saber, merge-partition). Puede utilizar una conexión nativa o una conexión HTTP para los servidores de Analysis Services que configuró para el acceso HTTP. En las ilustraciones siguientes se muestra la ruta de acceso de navegación de las conexiones HTTP y nativas. En las ilustraciones siguientes se muestra la ruta de acceso de navegación de las conexiones HTTP y nativas.

Conexiones nativas a Analysis Services

El ejemplo siguiente es una demostración de cómo utilizar una conexión nativa para navegar por la jerarquía de objetos. Desde el proveedor, puede emitir un dir para ver la información de la instancia. Puede utilizar cd para ver los objetos de esa instancia.

PS SQLSERVER:> cd sqlas
PS SQLSERVER\sqlas:> dir
PS SQLSERVER\sqlas:> cd localhost\default
PS SQLSERVER\sqlas\localhost\default:> dir

Debe ver las colecciones siguientes: ensamblados, bases de datos, roles y seguimientos. Si continúa utilizando cd y dir, puede ver el contenido de cada colección.

Conexiones HTTP a Analysis Services

Las conexiones HTTP son útiles si configuró al servidor para el acceso HTTP con las instrucciones de este tema: Configurar el acceso HTTP a Analysis Services en Internet Information Services (IIS) 7.0

Suponiendo que la dirección URL de un servidor fuera https://localhost/olap/msmdpump.dll, una conexión podría ser similar a la siguiente:

PS SQLSERVER\sqlas:> cd http_ds
PS SQLSERVER\sqlas\http_ds:> $Url=Encode-SqlName “https://localhost/olap/msmdpump.dll”
PS SQLSERVER\sqlas\http_ds:> cd $Url
PS SQLSERVER\sqlas\http_ds\http%3A%2F%2Flocalhost%2olap%2msmdpump%2Edll:> dir

Debe ver las colecciones siguientes: ensamblados, bases de datos, roles y seguimientos. Si no puede ver el contenido de estas colecciones, compruebe la configuración de la autenticación en el directorio virtual OLAP. Asegúrese de que el acceso anónimo está deshabilitado. Si utiliza la autenticación de Windows, asegúrese de que la cuenta de usuario de Windows tiene permisos administrativos en la instancia de Analysis Services.

Administrar el servicio

Compruebe que el servicio se está ejecutando. Devuelve el estado, el nombre y el nombre para mostrar de servicios de SQL Server, incluido Analysis Services (MSSQLServerOLAPService) y el motor de base de datos.

Get-service mssql*

Devuelve las propiedades de un proceso, incluido el identificador de proceso, el recuento de identificadores y el uso de memoria:

Get-process msmdsrv

Reinicia el servicio al emitir el cmdlet siguiente desde el shell de administración:

Restart-service mssqlserverolapservice

Obtener Ayuda para Analysis Services PowerShell

Use cualquiera de los siguientes cmdlets para comprobar su disponibilidad y obtener más información acerca de los servicios, los procesos y los objetos.

1. Get-help devuelve la Ayuda integrada para un cmdlet de Analysis Services, incluidos los ejemplos:

   Get-help invoke-ascmd -examples
   

2. Get-command devuelve una lista de los once cmdlets de Analysis Services PowerShell:

   get-command –module SQLASCmdlets
   

3. Get-member devuelve las propiedades o los métodos de un servicio o un proceso.

   Get-service mssqlserverolapservice | get-member –type Property
   
   Get-service mssqlserverolapservice | get-member –type Method
   
   Get-process msmdsrv | get-member –type Property
   

4. Get-member también se puede utilizar para devolver las propiedades o los métodos de un objeto (por ejemplo, los métodos AMO en el objeto de servidor) mediante el proveedor SQLAS para especificar la instancia de servidor.

   PS SQLSERVER:\sqlas\localhost\default > $serverObj = New-Object Microsoft.AnalysisServices.Server
   PS SQLSERVER:\sqlas\localhost\default > $serverObj = | get-member –type Method
   

5. Get-PSdrive devuelve una lista de los proveedores instalados actualmente. Si importó el módulo SQLPS, verá el proveedor SQLServer en la lista (SQLAS forma parte del proveedor SQLServer y nunca aparece de forma independiente en la lista):

   Get-PSDrive
   

Vea también

Conceptos

Instalar SQL Server PowerShell

Configurar el acceso HTTP a Analysis Services en Internet Information Services (IIS) 7.0

Otros recursos

Administrar modelos tabulares con PowerShell