Cmdlet Invoke-ASCmd

Artigo
05/07/2013

Permite que um administrador de banco de dados execute um script XMLA, instruções MDX ou DMX.

Sintaxe

Invoke-ASCmd –Query <string> [-Server <string>] [-Database <string>] [-Credential <PSCredential>] [-ConnectionTimeout <int>] [-QueryTimeout <int>] [-Variable <string[]>] [-TraceFile <string>] [-TraceFileFormat <TraceFileFormatOption>] [-TraceFileDelimiter <string>] [-TraceTimeout <int>] [-TraceLevel <TraceLevelOption>] [<CommonParameters>]

Invoke-ASCmd –InputFile <string> [-Server <string>] [-Database <string>] [-Credential <PSCredential>] [-ConnectionTimeout <int>] [-QueryTimeout <int>] [-Variable <string[]>] [-TraceFile <string>] [-TraceFileFormat <TraceFileFormatOption>] [-TraceFileDelimiter <string>] [-TraceTimeout <int>] [-TraceLevel <TraceLevelOption>] [<CommonParameters>]

Descrição

O cmdlet Invoke-ASCmd pode executar consultas ou scripts que estão contidos em arquivos de entrada. Os seguintes comandos têm suporte: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (usados para executar consultas MDX e instruções DMX), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Esse cmdlet oferece suporte ao parâmetro –Credential, que pode ser usado se você configurar a instância do Analysis Services para acesso HTTP. O parâmetro –Credential usa o objeto PSCredential que fornece uma identidade de usuário do Windows. O IIS representará esse usuário ao conectar-se ao Analysis Services. A identidade deve ter permissões de administrador de sistema na instância do Analysis Services para executar o script.

Parâmetros

-Query <string>

Especifica o script, consulta ou instrução atual diretamente na linha de comando em vez de em um arquivo. Você também pode especificar uma consulta como entrada do pipeline. Você deve especificar um valor para os parâmetros –InputFile ou –Query ao usar Invoke-AsCmd.

Obrigatório?	true
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	True (ByValue)
Aceitar caracteres curinga?	false

-InputFile <string>

Identifica o arquivo que contém o script XMLA, a consulta MDX ou a instrução DMX. Você deve especificar um valor para os parâmetros –InputFile ou –Query ao usar Invoke-AsCmd.

Obrigatório?	true
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-Server <cadeia de caracteres>

Especifica a instância do Analysis Services que o cmdlet conectará e executará. Se nenhum nome de servidor for fornecido, uma conexão será feita com o localhost. Para instâncias padrão, especifique apenas o nome do servidor. Para instâncias nomeadas, use o formato nome_do_servidor\nome_da_instância. Para conexões HTTP, use o formato http[s]://servidor[:porta]/diretório_virtual/msmdpump.dll.

Obrigatório?	false
Posição?	nomeado
Valor padrão	localhost
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-Database <cadeia de caracteres>

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.

Obrigatório?	false
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-Credential <PSCredential>

Especifica um objeto –Credential que fornece um nome de usuário e senha do Windows. Especifique esse parâmetro somente se a instância do Analysis Services estiver configurada para acesso HTTP, usando a autenticação básica. Para conexões nativas que usam a segurança integrada, esse parâmetro é ignorado.

Se esse parâmetro estiver presente, as credenciais que ele fornece serão anexadas à cadeia de conexão. O IIS representará essa identidade de usuário ao conectar-se ao Analysis Services. Se nenhuma credencial for especificada, será usada a conta do Windows padrão do usuário que está executando a ferramenta.

Para usar este parâmetro, primeiro crie um objeto PSCredential usando Get-Credential para especificar o nome de usuário e a senha (por exemplo, $Cred=Get-Credential “adventure-works\admin”. Você pode transportar este objeto para o parâmetro –Credential (-Credential:$Cred).

Para obter mais informações sobre a autenticação e o uso de credenciais, consulte Analysis Services PowerShell. Para obter mais informações sobre o acesso à HTTP, consulte Configurar o acesso HTTP ao Analysis Services no IIS (Serviços de Informações da Internet 7.0.

Obrigatório?	false
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	True (ByValue)
Aceitar caracteres curinga?	false

-ConnectionTimeout <int>

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

Obrigatório?	false
Posição?	nomeado
Valor padrão	30
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-QueryTimeout <int>

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

Obrigatório?	false
Posição?	nomeado
Valor padrão	30
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-Variable <string[]>

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.

Obrigatório?	false
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-TraceFile <string>

Identifica um arquivo que recebe eventos de rastreamento do Analysis Services enquanto executa o script XMLA, consulta MDX ou instrução DMX. Se o arquivo já existir, será substituído automaticamente (exceto os arquivos de rastreamento criados usando as configurações de parâmetro -TraceLevel:Duration e –TraceLevel:DurationResult). Nomes de arquivo que contêm espaço devem ser incluídos entre aspas (" "). Se o nome do arquivo for inválido, uma mensagem de erro será gerada.

Obrigatório?	false
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-TraceFileFormat <string>

Especifica o formato de arquivo para o parâmetro –TraceFile (quando esse parâmetro estiver especificado). As opções disponíveis são texto ou csv. O valor padrão é "csv".

Obrigatório?	false
Posição?	nomeado
Valor padrão	csv
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-TraceFileDelimiter <string>

Especifica qual caractere deve ser usado como o delimitador do arquivo de rastreamento, quando o formato de arquivo de rastreamento .csv for especificado. O padrão é | (barra vertical).

Obrigatório?	false
Posição?	nomeado
Valor padrão
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-TraceTimeout <int>

Especifica o número de segundos que o mecanismo do Analysis Services espera antes de encerrar o rastreamento (caso o parâmetro –TraceFile seja especificado). 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.

Obrigatório?	false
Posição?	nomeado
Valor padrão	5
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

-TraceLevel <TraceLevelOption>

Especifica quais dados são coletados e registrados no arquivo de rastreamento. Os valores possíveis valores são: High, Medium, Low, Duration, DurationResult.

Obrigatório?	false
Posição?	nomeado
Valor padrão	High
Aceitar entrada de pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Este cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte About_CommonParameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode transportar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	PSObject
Saídas	Cadeia de caracteres

Exemplo 1

Invoke-ASCmd –InputFile:”C:\MyFolder\DiscoverConnections.xmla”

Este comando executa um script XMLA que retorna a lista de conexões ativas no servidor. O arquivo DiscoverConnections.xmla contém o script XMLA a seguir:

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CONNECTIONS</RequestType>

<Restrictions />

<Properties>

<PropertyList>

<Content>Data</Content>

</PropertyList>

</Properties>

</Discover>

Exemplo 2

Invoke-ASCmd -Database:"Adventure Works DW" -Query:"<Discover xmlns='urn:schemas-microsoft-com:xml analysis'><RequestType>DISCOVER_DATASOURCES</RequestType><Restrictions></Restrictions><Properties></Properties></Discover>"

A consulta Discover XMLA retorna fontes de dados disponíveis para o Analysis Server e as informações necessárias para se conectar a elas. Os resultados estão em XML. Para obter uma melhor legibilidade, você pode transmitir a saída para um arquivo XML (por exemplo, adicione | Out-file C:\Results\XMLAQueryOutput.xml ao comando) e exibir os resultados em um navegador ou outro aplicativo que dê suporte a XML estruturado.

Compartilhar via