Invoke-ASCmd

Referencia

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.

Sintaxis

Invoke-ASCmd
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-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>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

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

Description

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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CertificateThumbprint

Huella digital del certificado para la entidad de servicio.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 el InputFile o el parámetro *Query *cuando se usa Invoke-AsCmd.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ProgressAction

Determina cómo Responde PowerShell a las actualizaciones de progreso generadas por un script, cmdlet o proveedor, como las barras de progreso generadas por el cmdlet Write-Progress. El cmdlet Write-Progress crea barras de progreso que muestran el estado de un comando.

Tipo:	ActionPreference
Alias:	proga
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Server

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ServicePrincipal

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TenantId

Identificador de inquilino de la entidad de servicio.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TraceFileFormat

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

El valor predeterminado es "Csv".

Tipo:	TraceFileFormatOption
Valores aceptados:	Csv, Text
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-TraceLevel

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

Tipo:	TraceLevelOption
Valores aceptados:	High, Medium, Low, Duration, DurationResult
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

PSObject

Salidas

string

Notas

Se admite en todas las instancias de Analysis Services, incluido PowerBI Premium

Compartir a través de