Invoke-ASCmd

Modulo:

SQLServer

Consente agli amministratori di database di eseguire uno script XMLA, uno script TMSL, una query DAX (Data Analysis Expressions), una query MDX (Multidimensional Expressions) o un'istruzione DMX (Data Mining Extensions) su un'istanza di Analysis Services.

Sintassi

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

Descrizione

Consente agli amministratori di database di eseguire uno script XMLA, uno script TMSL, una query DAX (Data Analysis Expressions), una query MDX (Multidimensional Expressions) o un'istruzione DMX (Data Mining Extensions) su un'istanza di Analysis Services.

Esecuzione dei cmdlet di queste query o script all'interno di file di input.

Lo script passato è un comando XMLA e sono supportati i comandi seguenti: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (usato per eseguire query MDX e istruzioni DMX), Sottoscrizione, Sblocco, UpdateCells.

Questo script accetta anche comandi JSON progettati per l'esecuzione in un database tabulare con modalità di compatibilità 1200 o successiva.

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

Esempio

Richiamare l'individuazione

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

Richiamare l'individuazione 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>"

Richiama selezionare

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

Richiama selezionare 2

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

Richiamare con il file 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>

#>

Parametri

-ApplicationId

ID applicazione per l'entità servizio.

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

-CertificateThumbprint

Identificazione personale del certificato per l'entità servizio.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-ConnectionString

Specifica la stringa di connessione.

Si noti che altre proprietà a livello di connessione, ad esempio Server, Database e così via. vengono ignorati quando questa proprietà viene specificata e pertanto queste proprietà devono essere incluse nella stringa di connessione.

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

-ConnectionTimeout

Specifica il numero di secondi prima del timeout della connessione all'istanza di Analysis Services. Il valore di timeout deve essere un intero compreso tra 0 e 65534. Se si specifica 0, non si verifica alcun timeout dei tentativi di connessione.

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

-Credential

Se questo parametro viene specificato, il nome utente e la password passati verranno utilizzati per la connessione all'istanza di Analysis Server specificata. Se non viene specificata alcuna credenziale, verrà utilizzato l'account predefinito di Windows dell'utente che sta eseguendo lo strumento.

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

-Database

Specifica il database su cui deve essere eseguita una query MDX o un'istruzione DMX. Il parametro del database viene ignorato se tramite il cmdlet viene eseguito uno script XMLA, poiché il nome del database viene incorporato nello script stesso.

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

-InputFile

Identifica il file contenente lo script XMLA, la query MDX, l'istruzione DMX o lo script TMSL (in JSON). È necessario specificare un valore per InputFile o il parametro *Query *quando si usa Invoke-AsCmd.

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

-Query

Specifica la query, l'istruzione o lo script effettivo direttamente nella riga di comando anziché in un file.

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

-QueryTimeout

Specifica il numero di secondi prima del timeout delle query. Se non è specificato un valore di timeout, le query non eseguono il timeout. Il timeout deve essere un intero compreso tra 1 e 65535.

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

-Server

Facoltativamente specifica l'istanza del server da connettere a se non è attualmente presente nella directory del provider SQLAS.

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

-ServicePrincipal

Specifica che questa connessione usa l'entità servizio.

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

-TenantId

ID tenant per l'entità servizio.

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

-TraceFile

Identifica un file che riceve gli eventi di traccia di Analysis Services durante l'esecuzione dello script XMLA, della query MDX o dell'istruzione DMX. Se il file esiste già, viene sovrascritto automaticamente (ad eccezione dei file di traccia creati usando le impostazioni del parametro -TraceLevel:Duration e -TraceLevel:DurationResult).

I nomi di file contenenti spazi devono essere racchiusi tra virgolette ("").

Se il nome file non è valido, viene generato un messaggio di errore.

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

-TraceFileDelimiter

Specifica un singolo carattere come delimitatore di file di traccia quando si specifica csv come formato per il file di traccia che utilizza il parametro -TraceFileFormat.

Il carattere predefinito è | (barra verticale).

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

-TraceFileFormat

Specifica il formato di file per il parametro -TraceFile (se questo parametro è specificato).

Il valore predefinito è "Csv".

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

-TraceLevel

Specifica quali dati vengono raccolti e registrati nel file di traccia. I valori possibili sono 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

Specifica il numero di secondi in cui il motore di Analysis Services attende prima di terminare la traccia ( se si specifica il parametro -TraceFile).

La traccia viene considerata conclusa se non viene registrato alcun messaggio durante il periodo di tempo specificato.

Il valore di timeout di traccia predefinito è di 5 secondi.

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

-Variables

Specifica ulteriori variabili di scripting. Ogni variabile è una coppia nome-valore. Se nel valore sono contenuti spazi o caratteri di controllo incorporati, è necessario racchiuderlo tra virgolette doppie Utilizzare una matrice di PowerShell per specificare più variabili e i relativi valori.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

PSObject

Output

string

Note

Supportato in tutte le istanze di Analysis Services, tra cui PowerBI Premium