Compartir a través de

Invoke-ASCmd

Módulo:
SqlServer Module

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.

Sintaxis

QuerySet (Es el valor predeterminado). 

Invoke-ASCmd
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ParameterSetName 

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>]

ParameterSetInputObject 

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>]

ParameterSetTabularName 

Invoke-ASCmd
    [-Server <String>]
    [-Credential <PSCredential>]
    [-ServicePrincipal]
    [-ApplicationId <String>]
    [-TenantId <String>]
    [-CertificateThumbprint <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ParameterSetTabularInputObject 

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.

La ejecución de cmdlets de estas consultas o scripts dentro de los 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 (que se usa 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

Invocación de 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 select

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 select 2

Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "SELECT MODEL_CATALOG, MODEL_NAME, ATTRIBUTE_NAME, NODE_NAME FROM [Forecasting].CONTENT"

Invocación con 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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateThumbprint

Huella digital del certificado para la entidad de servicio.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 tanto, estas propiedades deben incluirse en la cadena de conexión.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 agoten el tiempo de espera.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Credential

Si se especifica este parámetro, el nombre de usuario y la contraseña pasados se usarán para conectarse a la instancia de Analysis Server especificada. Si no se especifica ninguna credencial, se usará la cuenta de Windows predeterminada del usuario que ejecuta la herramienta.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Database

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Query

Especifica el script real, la consulta o la instrucción directamente en la línea de comandos en lugar de en un archivo.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Server

Opcionalmente, especifica la instancia del servidor a la que conectarse si no está actualmente en el directorio proveedor de SQLAS.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServicePrincipal

Especifica que esta conexión usa la entidad de servicio.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TenantId

Identificador de inquilino de la entidad de servicio.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetTabularInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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 incluirse entre comillas ("").

Si el nombre de archivo no es válido, se genera un mensaje de error.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TraceFileDelimiter

Especifica un carácter único 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 o canalización).

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TraceFileFormat

Especifica el formato de archivo para el parámetro -TraceFile (si se especifica este parámetro).

El valor predeterminado es "Csv".

Propiedades del parámetro

Tipo:TraceFileFormatOption
Valor predeterminado:None
Valores aceptados:Csv, Text
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TraceLevel

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

Propiedades del parámetro

Tipo:TraceLevelOption
Valor predeterminado:None
Valores aceptados:High, Medium, Low, Duration, DurationResult
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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).

El seguimiento se considera finalizado si no se ha registrado ningún mensaje de seguimiento durante el período de tiempo especificado.

El valor de tiempo de espera de seguimiento predeterminado es de 5 segundos.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Variables

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

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ParameterSetName
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ParameterSetInputObject
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSObject

Salidas

string