Invoke-ASCmd

Módulo:

SQLServer

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