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