Invoke-ASCmd
Permite a los administradores de bases de datos ejecutar un script XMLA, un script TMSL, una consulta de expresiones de análisis de datos (DAX), una consulta de expresiones multidimensionales (MDX) o una instrucción extensiones de minería de datos (DMX) en una instancia de Analysis Services.
Syntax
Invoke-ASCmd
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-ASCmd
[-Database <String>]
[-Query <String>]
[-ConnectionString <String>]
[-QueryTimeout <Int32>]
[-ConnectionTimeout <Int32>]
[-TraceFile <String>]
[-Variables <String[]>]
[-TraceTimeout <Int32>]
[-TraceLevel <TraceLevelOption>]
[-TraceFileFormat <TraceFileFormatOption>]
[-TraceFileDelimiter <String>]
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-ASCmd
[-Database <String>]
[-ConnectionString <String>]
[-InputFile <String>]
[-QueryTimeout <Int32>]
[-ConnectionTimeout <Int32>]
[-TraceFile <String>]
[-Variables <String[]>]
[-TraceTimeout <Int32>]
[-TraceLevel <TraceLevelOption>]
[-TraceFileFormat <TraceFileFormatOption>]
[-TraceFileDelimiter <String>]
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-ASCmd
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-ASCmd
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Permite a los administradores de bases de datos ejecutar un script XMLA, un script TMSL, una consulta de expresiones de análisis de datos (DAX), una consulta de expresiones multidimensionales (MDX) o una instrucción extensiones de minería de datos (DMX) en una instancia de Analysis Services.
Ejecución de cmdlets de estas consultas o scripts en archivos de entrada.
El script que se pasa es un comando XMLA y se admiten los siguientes comandos: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (usado para ejecutar consultas MDX y instrucciones DMX), Subscribe, Synchronize, Unlock, Update, UpdateCells.
Este script también aceptará comandos JSON diseñados para ejecutarse en una base de datos tabular con el modo de compatibilidad 1200 o superior.
Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.
Ejemplos
Invocar detección
Invoke-ASCmd -Server:localhost -Query "<Discover xmlns='urn:schemas-microsoft-com:xml-analysis'><RequestType>DBSCHEMA_CATALOGS</RequestType><Restrictions /><Properties /></Discover>"
Invocar detección 2
Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "<Discover xmlns='urn:schemas-microsoft-com:xml-analysis'><RequestType>DISCOVER_DATASOURCES</RequestType><Restrictions></Restrictions><Properties></Properties></Discover>"
Invocación de selección
Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "SELECT {[Measures].[Internet Sales Amount]} ON COLUMNS, BOTTOMCOUNT(NONEMPTY(DESCENDANTS( [Customer].[Customer Geography].[All Customers], [Customer].[Customer Geography].[Customer]), ( [Measures].[Internet Sales Amount] ) ), 10, ( [Measures].[Internet Sales Amount] )) ON ROWS FROM [Adventure Works] WHERE ( [Date].[Calendar].[Calendar Year].&[2008] )"
Invocación de selección 2
Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "SELECT MODEL_CATALOG, MODEL_NAME, ATTRIBUTE_NAME, NODE_NAME FROM [Forecasting].CONTENT"
Invocación con el archivo xmla
Invoke-ASCmd -InputFile C:\MyFolder\DiscoverConnections.xmla
<# DiscoverConnections.xmla is as follows:
<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CONNECTIONS</RequestType>
<Restrictions />
<Properties>
<PropertyList>
<Content>Data</Content>
</PropertyList>
</Properties>
</Discover>
#>
Parámetros
-ApplicationId
Identificador de aplicación de la entidad de servicio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Huella digital del certificado para la entidad de servicio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionString
Especifica la cadena de conexión.
Tenga en cuenta que otras propiedades de nivel de conexión, como Servidor, Base de datos, etc. se omiten cuando se especifica esta propiedad y, por lo tanto, estas propiedades deben incluirse en la cadena de conexión.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionTimeout
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 valor de tiempo de espera debe ser un entero entre 0 y 65534. Si se especifica 0, los intentos de conexión no tienen tiempo de espera.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Si se especifica este parámetro, el nombre de usuario y la contraseña pasadas se utilizarán para conectarse a la instancia de Analysis Server especificada. Si no se especifica ninguna credencial, se utilizará la cuenta predeterminada de Windows del usuario que ejecuta la herramienta.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputFile
Identifica el archivo que contiene el script XMLA, la consulta MDX, la instrucción DMX o el script TMSL (en JSON). Debe especificar un valor para inputFile o el parámetro *Query *al usar Invoke-AsCmd.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
Especifica el script, la consulta o la instrucción reales directamente en la línea de comandos en lugar de hacerlo en un archivo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryTimeout
Especifica el número de segundos antes de que se agote el tiempo de espera de las consultas. Si no se especifica un valor de tiempo de espera, las consultas no agota el tiempo de espera. El tiempo de espera debe ser un entero entre 1 y 65535.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Server
Opcionalmente, especifica la instancia del servidor a la que conectarse si no está actualmente en el directorio del proveedor SQLAS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServicePrincipal
Especifica que esta conexión usa la entidad de servicio.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantId
Identificador de inquilino de la entidad de servicio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceFile
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 el archivo ya existe, se sobrescribe automáticamente (excepto los archivos de seguimiento creados mediante la configuración del parámetro -TraceLevel:Duration y -TraceLevel:DurationResult).
Los nombres de archivo que contienen espacios deben ir entre comillas ("").
Si el nombre de archivo no es válido, se genera un mensaje de error.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceFileDelimiter
Especifica un solo carácter como delimitador de archivo de seguimiento cuando se especifica csv como formato para el archivo de seguimiento que usa el parámetro -TraceFileFormat.
El valor predeterminado es | (barra vertical).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceFileFormat
Especifica el formato de archivo para el parámetro -TraceFile (si se especifica este parámetro).
El valor predeterminado es "Csv".
Type: | TraceFileFormatOption |
Accepted values: | Csv, Text |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceLevel
Especifica qué datos se recopilan y registran en el archivo de seguimiento. Los valores posibles son High, Medium, Low, Duration y DurationResult.
Type: | TraceLevelOption |
Accepted values: | High, Medium, Low, Duration, DurationResult |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceTimeout
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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variables
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
PSObject
Salidas
string
Notas
Compatible con todas las instancias de Analysis Services, incluido PowerBI Premium