Compartilhar via


Invoke-ASCmd

Permite que os administradores de banco de dados executem um script XMLA, um script TMSL, uma consulta DAX (Data Analysis Expressions), uma consulta MDX (Expressões Multidimensionais) ou uma instrução DMX (Data Mining Extensions) em uma instância do Analysis Services.

Sintaxe

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

Permite que os administradores de banco de dados executem um script XMLA, um script TMSL, uma consulta DAX (Data Analysis Expressions), uma consulta MDX (Expressões Multidimensionais) ou uma instrução DMX (Data Mining Extensions) em uma instância do Analysis Services.

A execução de cmdlets dessas consultas ou scripts em 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), Assinar, Sincronizar, Desbloquear, Atualizar, AtualizarCells.

Esse script também aceitará comandos JSON projetados para executar 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 seleção 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CertificateThumbprint

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 ignoradas quando essa propriedade é especificada e, portanto, essas propriedades devem ser incluídas na cadeia de conexão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 chegarão ao tempo limite.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

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

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Database

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputFile

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProgressAction

Determina como o PowerShell responde às atualizações de progresso geradas por um script, cmdlet ou provedor, como as barras de progresso geradas pelo cmdlet Write-Progress. O cmdlet Write-Progress cria barras de progresso que mostram o status de um comando.

Tipo:ActionPreference
Aliases:proga
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Query

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 perderão tempo limite. O tempo limite deve ser um inteiro entre 1 e 65535.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Server

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ServicePrincipal

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TraceFile

Identifica um arquivo que recebe eventos de rastreamento do Analysis Services durante a execução do script XMLA, da consulta MDX ou da 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 não for válido, uma mensagem de erro será gerada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TraceFileDelimiter

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

O padrão é | (pipe ou barra vertical).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TraceFileFormat

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

O valor padrão é "Csv".

Tipo:TraceFileFormatOption
Valores aceitos:Csv, Text
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TraceLevel

Especifica quais dados são coletados e registrados no arquivo de rastreamento. Os valores possíveis são Alto, Médio, Baixo, Duração, DurationResult.

Tipo:TraceLevelOption
Valores aceitos:High, Medium, Low, Duration, DurationResult
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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á considerado concluído se nenhuma mensagem de rastreamento tiver sido registrada durante o período de tempo especificado.

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Variables

Especifica variáveis de script adicionais. Cada variável é um par nome-valor. Se o valor contiver espaços inseridos ou caracteres de controle, ele deverá ser colocado entre aspas duplas. Use uma matriz do PowerShell para especificar várias variáveis e seus valores.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSObject

Saídas

string

Observações

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