Invoke-ASCmd

Riferimento

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

Descrizione

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), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Questo script accetterà anche i comandi JSON progettati per l'esecuzione su un database tabulare con la 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 discover 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 selezione

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

Richiamare select 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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CertificateThumbprint

Identificazione personale del certificato per l'entità servizio.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ConnectionString

Specifica la stringa di connessione.

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ConnectionTimeout

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

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

Se si specifica questo parametro, verranno usati il nome utente e la password passati per connettersi all'istanza di Analysis Server specificata. Se non viene specificato alcun account di windows predefinito dell'utente che esegue lo strumento, verrà usato.

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Database

Specifica il database in cui verrà eseguita una query MDX o un'istruzione DMX. Il parametro di database viene ignorato quando il cmdlet esegue uno script XMLA, perché il nome del database è incorporato nello script XMLA.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 il InputFile o il parametro *Query *quando si usa Invoke-AsCmd.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ProgressAction

Determina in che modo PowerShell risponde agli aggiornamenti dello stato generati da uno script, un cmdlet o un provider, ad esempio le barre di stato generate dal cmdlet Write-Progress. Il cmdlet Write-Progress crea barre di stato che mostrano lo stato di un comando.

Tipo:	ActionPreference
Alias:	proga
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Query

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-QueryTimeout

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

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Server

Facoltativamente, specifica l'istanza del server a cui connettersi se non è attualmente presente nella directory del provider SQLAS.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ServicePrincipal

Specifica che la connessione utilizza l'entità servizio.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TenantId

ID tenant per l'entità servizio.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TraceFile

Identifica un file che riceve 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 del file non è valido, viene generato un messaggio di errore.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TraceFileDelimiter

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

Il valore predefinito è | (barra verticale o barra verticale).

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TraceFileFormat

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

Il valore predefinito è "Csv".

Tipo:	TraceFileFormatOption
Valori accettati:	Csv, Text
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TraceLevel

Specifica i dati raccolti e registrati nel file di traccia. I valori possibili sono High, Medium, Low, Duration, DurationResult.

Tipo:	TraceLevelOption
Valori accettati:	High, Medium, Low, Duration, DurationResult
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TraceTimeout

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

La traccia viene considerata completata se non sono stati registrati messaggi di traccia durante il periodo di tempo specificato.

Il valore di timeout di traccia predefinito è 5 secondi.

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Variables

Specifica altre variabili di scripting. Ogni variabile è una coppia nome-valore. Se il valore contiene spazi incorporati o caratteri di controllo, deve essere racchiuso tra virgolette doppie. Usare una matrice di PowerShell per specificare più variabili e i relativi valori.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

PSObject

Output

string

Note

Supportato in tutte le istanze di Analysis Services, incluso PowerBI Premium

Condividi tramite