Invoke-ASCmd

Módulo:

SQLServer

Permite que os administradores de banco de dados executem um script XMLA, um script TMSL, uma consulta DAX (Data Analysis Expressions), uma consulta MDX (Multidimensional Expressions) ou uma instrução DMX (Data Mining Extensions) em uma instância do 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 que os administradores de banco de dados executem um script XMLA, um script TMSL, uma consulta DAX (Data Analysis Expressions), uma consulta MDX (Multidimensional Expressions) ou uma instrução DMX (Data Mining Extensions) em uma instância do Analysis Services.

A execução de cmdlets dessas consultas ou scripts dentro de arquivos de entrada.

O script que é passado é um comando XMLA e há suporte para os seguintes comandos: Alter, Backup, Lote, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (usado para executar consultas MDX e instruções DMX), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Esse script também aceitará comandos JSON projetados para serem executados em um banco de dados tabular com o modo de compatibilidade 1200 ou superior.

Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.

Exemplos

Invocar descoberta

Invoke-ASCmd -Server:localhost -Query "<Discover xmlns='urn:schemas-microsoft-com:xml-analysis'><RequestType>DBSCHEMA_CATALOGS</RequestType><Restrictions /><Properties /></Discover>"

Invocar descoberta 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>"

Invocar seleção

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

Invocar selecionar 2

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

Invocar com o arquivo 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

A ID do aplicativo para a entidade de serviço.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

A impressão digital do certificado para a entidade de serviço.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionString

Especifica a cadeia de conexão.

Observe que outras propriedades de nível de conexão, como Servidor, Banco de Dados etc. são ignorados quando essa propriedade é especificada e, portanto, essas propriedades devem ser incluídas na cadeia de conexão.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

Especifica o número de segundos antes do tempo limite da conexão com a instância do Analysis Services. O valor de tempo limite deve ser um inteiro entre 0 e 65534. Se 0 for especificado, as tentativas de conexão não atingirão o tempo limite.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Se este parâmetro for especificado, o nome de usuário e a senha serão passados para conectar à instância do Analysis Server especificado. Se nenhuma credencial for especificada, será usada a conta do Windows padrão do usuário que está executando a ferramenta.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

Especifica o banco de dados em que será executada uma consulta MDX ou uma instrução DMX. O parâmetro de banco de dados é ignorado quando o cmdlet executa um script XMLA, pois o nome de banco de dados está inserido no script XMLA.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputFile

Identifica o arquivo que contém o script XMLA, a consulta MDX, a instrução DMX ou o script TMSL (no JSON). Você deve especificar um valor para o InputFile ou o parâmetro *Query *ao usar Invoke-AsCmd.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

Especifica o script, consulta ou instrução atual diretamente na linha de comando em vez de em um arquivo.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QueryTimeout

Especifica o número de segundos antes do tempo limite das consultas. Se um valor de tempo limite não for especificado, as consultas não chegarão ao tempo limite. O tempo limite deve ser um inteiro entre 1 e 65535.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Server

Opcionalmente, especifica a instância de servidor à qual se conectar se não estiver atualmente no diretório provedor SQLAS.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

Especifica que essa conexão está usando a entidade de serviço.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantId

A ID do locatário da entidade de serviço.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFile

Identifica um arquivo que recebe eventos de rastreamento do Analysis Services ao executar o script XMLA, a consulta MDX ou a instrução DMX. Se o arquivo já existir, ele será substituído automaticamente (exceto pelos arquivos de rastreamento criados usando as configurações de parâmetro -TraceLevel:Duration e -TraceLevel:DurationResult).

Os nomes de arquivo que contêm espaços devem ser colocados entre aspas ("").

Se o nome do arquivo for inválido, uma mensagem de erro será gerada.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFileDelimiter

Especifica um único caractere como o delimitador de arquivo de rastreamento quando você especifica csv como o formato para o arquivo de rastreamento que usa o parâmetro -TraceFileFormat.

O padrão é | (barra vertical).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFileFormat

Especifica o formato de arquivo para o parâmetro -TraceFile (se esse parâmetro for especificado).

O valor padrão é "Csv".

Type:	TraceFileFormatOption
Accepted values:	Csv, Text
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceLevel

Especifica quais dados são coletados e registrados no arquivo de rastreamento. Os valores possíveis valores são: High, Medium, Low, Duration, 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 o número de segundos que o mecanismo do Analysis Services aguarda antes de encerrar o rastreamento (se você especificar o parâmetro -TraceFile).

O rastreamento será dado como encerrado se nenhuma mensagem de rastreamento for registrada durante o período de tempo especificado.

O valor do tempo limite de rastreamento padrão é 5 segundos.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Variables

Especifica variáveis de script adicionais. Cada variável é um par de nome-valor. Se o valor contém espaços inseridos ou caracteres de controle, ele deve estar entre aspas duplas("). Use uma matriz do PowerShell para especificar as diversas variáveis e seus valores.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

PSObject

Saídas

string

Observações

Com suporte em todas as instâncias do Analysis Services, incluindo o PowerBI Premium