Cmdlet Invoke-ASCmd

Artículo
05/08/2013

Permite a un administrador de bases de datos ejecutar instrucciones de script XMLA, MDX (expresiones multidimensionales) o DMX (extensiones de minería de datos).

Sintaxis

Invoke-ASCmd –Query <string> [-Server <string>] [-Database <string>] [-Credential <PSCredential>] [-ConnectionTimeout <int>] [-QueryTimeout <int>] [-Variable <string[]>] [-TraceFile <string>] [-TraceFileFormat <TraceFileFormatOption>] [-TraceFileDelimiter <string>] [-TraceTimeout <int>] [-TraceLevel <TraceLevelOption>] [<CommonParameters>]

Invoke-ASCmd –InputFile <string> [-Server <string>] [-Database <string>] [-Credential <PSCredential>] [-ConnectionTimeout <int>] [-QueryTimeout <int>] [-Variable <string[]>] [-TraceFile <string>] [-TraceFileFormat <TraceFileFormatOption>] [-TraceFileDelimiter <string>] [-TraceTimeout <int>] [-TraceLevel <TraceLevelOption>] [<CommonParameters>]

Descripción

El cmdlet Invoke-ASCmd puede ejecutar las consultas o los scripts contenidos en los archivos de entrada. Se admiten los siguientes comandos: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (que se usan para ejecutar consultas MDX e instrucciones DMX), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Este cmdlet admite el parámetro –Credential, que se puede usar si configuró la instancia de Analysis Services para el acceso HTTP. El parámetro –Credential toma un objeto PSCredential que proporciona una identidad de usuario de Windows. A continuación, IIS suplantará a este usuario al conectarse a Analysis Services. La identidad debe tener permisos de administrador del sistema en la instancia de Analysis Services para ejecutar el script.

Parámetros

-Query <string>

Especifica el script, la consulta o la instrucción reales directamente en la línea de comandos en lugar de hacerlo en un archivo. También puede especificar una consulta como entrada de la canalización. Debe especificar un valor para el parámetro –InputFile o –Query al utilizar Invoke-AsCmd.

¿Obligatorio?	true
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	True (ByValue)
¿Aceptar caracteres comodín?	false

-InputFile <string>

Identifica el archivo que contiene el script XMLA, la consulta MDX o la instrucción DMX. Debe especificar un valor para el parámetro –InputFile o –Query al utilizar Invoke-AsCmd.

¿Obligatorio?	true
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Server <string>

Especifica la instancia de Analysis Services a la que el cmdlet se conectará y ejecutará. Si no se proporciona un nombre de servidor, se establecerá una conexión al host local. Para las instancias predeterminadas, especifique solo el nombre del servidor. Para las instancias con nombre, utilice el formato nombreDeServidor\nombreDeInstancia. En las conexiones HTTP, utilice el formato http[s]://server[:port]/virtualdirectory/msmdpump.dll.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado	localhost
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Database <string>

Especifica la base de datos en la que se ejecutará una consulta MDX o una instrucción DMX. El parámetro database se omite cuando el cmdlet ejecuta un script XMLA, ya que el script XMLA incluye el nombre de la base de datos.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Credential <PSCredential>

Especifica un objeto PSCredential que proporciona el nombre de usuario y contraseña de Windows. Especifique este parámetro solo si la instancia de Analysis Services está configurada para el acceso HTTP con autenticación básica. Para las conexiones nativas que usan seguridad integrada, este parámetro se omite.

Si este parámetro está presente, las credenciales que proporcione se anexan a la cadena de conexión. IIS suplantará esta identidad de usuario al conectarse a Analysis Services. Si no se especifica ninguna credencial, se usará la cuenta predeterminada de Windows del usuario que ejecuta la herramienta.

Para utilizar este parámetro, cree primero un objeto PSCredential con Get-Credential para especificar el nombre de usuario y la contraseña (por ejemplo, $Cred=Get-Credential “adventure-works\admin”. Después puede canalizar este objeto al parámetro –Credential (-Credential:$Cred).

Para obtener más información acerca de la autenticación y el uso de credenciales, vea Analysis Services PowerShell. Para obtener más información acerca del acceso HTTP, vea Configurar el acceso HTTP a Analysis Services en Internet Information Services (IIS) 7.0.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	True (ByValue)
¿Aceptar caracteres comodín?	false

-ConnectionTimeout <int>

Especifica el número de segundos antes de que se agote el tiempo de espera de la conexión a la instancia de Analysis Services. El tiempo de espera debe ser un entero comprendido entre 0 y 65534. Si se especifica 0, los intentos de conexión no tienen tiempo de espera.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado	30
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-QueryTimeout <int>

Especifica el número de segundos que tienen que transcurrir antes de que las consultas agoten el tiempo de espera. Si no se especifica ningún valor de tiempo de espera, las consultas no agotan el tiempo de espera. El tiempo de espera debe ser un entero comprendido entre 1 y 65535.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado	30
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-Variable <string[]>

Especifica variables de scripting adicionales. Cada variable es un par de nombre y valor. Si el valor contiene caracteres de control o espacios incrustados, debe ponerse entre comillas dobles. Use una matriz de PowerShell para especificar varias variables y sus valores.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-TraceFile <string>

Identifica un archivo que recibe eventos de seguimiento de Analysis Services al ejecutar el script XMLA, la consulta MDX o la instrucción DMX. Si ya existe el archivo, se sobrescribe automáticamente (a excepción de los archivos de seguimiento que se crean con configuración de los parámetros the -TraceLevel:Duration y –TraceLevel:DurationResult). Los nombres de archivo que contienen espacios deben incluirse entre comillas (" "). Si el nombre de archivo no es válido, se genera un mensaje de error.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-TraceFileFormat <string>

Especifica el formato de archivo del parámetro –TraceFile (si se ha especificado dicho parámetro). Las opciones disponibles son texto o csv. El valor predeterminado es “csv".

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado	csv
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-TraceFileDelimiter <string>

Especifica qué carácter usar como delimitador del archivo de seguimiento al especificar csv como formato del archivo de seguimiento. El valor predeterminado es | (barra vertical).

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-TraceTimeout <int>

Especifica el número de segundos que el motor de Analysis Services espera antes de finalizar el seguimiento (si especifica el parámetro –TraceFile). Se considera que el seguimiento ha terminado si no se han registrado mensajes relacionados con él durante el período de tiempo especificado. El valor predeterminado del tiempo de espera de seguimiento es de 5 segundos.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado	5
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

-TraceLevel <TraceLevelOption>

Especifica qué datos se recopilan y registran en el archivo de seguimiento. Los valores posibles son High, Medium, Low, Duration y DurationResult.

¿Obligatorio?	false
¿Posición?	con nombre
Valor predeterminado	High
¿Aceptar la entrada de la canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea Acerca de CommonParameters.

Entradas y salidas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet. El tipo de valor devuelto es el tipo de objeto que el cmdlet devuelve.

Entradas	PSObject
Salidas	Cadena

Ejemplo 1

Invoke-ASCmd –InputFile:”C:\MyFolder\DiscoverConnections.xmla”

Este comando ejecuta un script XMLA que devuelve la lista de conexiones activas en el servidor. El archivo DiscoverConnections.xmla contiene el script XMLA siguiente:

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CONNECTIONS</RequestType>

<Restrictions />

<Properties>

<PropertyList>

<Content>Data</Content>

</PropertyList>

</Properties>

</Discover>

Ejemplo 2

Invoke-ASCmd -Database:"Adventure Works DW" -Query:"<Discover xmlns='urn:schemas-microsoft-com:xml analysis'><RequestType>DISCOVER_DATASOURCES</RequestType><Restrictions></Restrictions><Properties></Properties></Discover>"

La consulta de detección XMLA devuelve los orígenes de datos disponibles de Analysis Services y la información necesaria para conectarse a ellos. Los resultados están en XML. Para mejorar la legibilidad, puede canalizar la salida a un archivo XML (por ejemplo, anexe | Out-file C:\Results\XMLAQueryOutput.xml al comando) y vea los resultados en el explorador u otra aplicación que admita XML estructurado.

Compartir a través de