Invoke-ASCmd
Permet aux administrateurs de base de données d’exécuter un script XMLA, un script TMSL, une requête DAX (Data Analysis Expressions), une requête MDX (Multidimensional Expressions) ou une instruction DMX (Data Mining Extensions) sur un instance d’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
Permet aux administrateurs de base de données d’exécuter un script XMLA, un script TMSL, une requête DAX (Data Analysis Expressions), une requête MDX (Multidimensional Expressions) ou une instruction DMX (Data Mining Extensions) sur un instance d’Analysis Services.
Exécution des applets de commande de ces requêtes ou scripts dans les fichiers d’entrée.
Le script passé est une commande XMLA et les commandes suivantes sont prises en charge : Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (utilisé pour exécuter des requêtes MDX et des instructions DMX), Subscribe, Synchronize, Unlock, UpdateCells.
Ce script accepte également les commandes JSON conçues pour s’exécuter sur une base de données tabulaire avec le mode de compatibilité 1200 ou supérieur.
Module requirements: version 21+ on PowerShell 5.1; version 21 (recent preview) or version 22+ on PowerShell 7.x.
Exemples
Appeler la découverte
Invoke-ASCmd -Server:localhost -Query "<Discover xmlns='urn:schemas-microsoft-com:xml-analysis'><RequestType>DBSCHEMA_CATALOGS</RequestType><Restrictions /><Properties /></Discover>"
Appeler 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>"
Appeler la sélection
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] )"
Appeler la sélection 2
Invoke-ASCmd -Database "Adventure Works DW 2008R2" -Query "SELECT MODEL_CATALOG, MODEL_NAME, ATTRIBUTE_NAME, NODE_NAME FROM [Forecasting].CONTENT"
Appeler avec le fichier 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>
#>
Paramètres
-ApplicationId
ID d’application pour le principal de service.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Empreinte numérique du certificat pour le principal de service.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionString
Spécifie la chaîne de connexion.
Notez que d’autres propriétés au niveau de la connexion telles que Serveur, Base de données, etc. sont ignorés lorsque cette propriété est spécifiée et doivent donc être incluses dans la chaîne de connexion.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionTimeout
Spécifie le nombre de secondes avant l’expiration de la connexion au instance Analysis Services. La valeur du délai d’expiration doit être un entier compris entre 0 et 65534. Si la valeur 0 est spécifiée, les tentatives de connexion n'expirent pas.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Si ce paramètre est indiqué, le nom d'utilisateur et le mot de passe passés seront utilisés pour la connexion à l'instance du serveur d'analyse spécifiée. Si aucune information d'identification n'est indiquée, le compte Windows par défaut de l'utilisateur qui exécute l'outil sera utilisé.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Database
Indique la base de données dans laquelle la requête MDX ou l'instruction DMX s'exécutera. Le paramètre de base de données est ignoré lorsque l'applet de commande exécute un script XMLA, car le nom de la base de données est incorporé dans le script XMLA.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputFile
Identifie le fichier qui contient le script XMLA, la requête MDX, l’instruction DMX ou le script TMSL (dans JSON). Vous devez spécifier une valeur pour le paramètre InputFile ou *Query *lors de l’utilisation d’Invoke-AsCmd.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Query
Spécifie le script, la requête ou l'instruction directement sur la ligne de commande plutôt que dans un fichier.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryTimeout
Spécifie le nombre de secondes avant l’expiration des requêtes. Si aucune valeur de délai d’expiration n’est spécifiée, les requêtes n’expirent pas. Le délai d’expiration doit être un entier compris entre 1 et 65535.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Server
Spécifie éventuellement le serveur instance auquel se connecter s’il n’est pas actuellement dans le répertoire du fournisseur SQLAS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServicePrincipal
Spécifie que cette connexion utilise le principal de service.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TenantId
ID de locataire pour le principal de service.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceFile
Identifie un fichier qui reçoit des événements de trace Analysis Services lors de l'exécution du script XMLA, de la requête MDX ou de l'instruction DMX. Si le fichier existe déjà, il est automatiquement remplacé (à l’exception des fichiers de trace créés à l’aide des paramètres -TraceLevel:Duration et -TraceLevel:DurationResult).
Les noms de fichiers qui contiennent des espaces doivent être placés entre guillemets (« »).
Si le nom de fichier n'est pas valide, un message d'erreur est généré.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceFileDelimiter
Spécifie un caractère unique comme délimiteur de fichier de trace lorsque vous spécifiez csv comme format pour le fichier de trace qui utilise le paramètre -TraceFileFormat.
Le délimiteur par défaut est | (barre verticale).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceFileFormat
Spécifie le format de fichier pour le paramètre -TraceFile (si ce paramètre est spécifié).
La valeur par défaut est « Csv ».
Type: | TraceFileFormatOption |
Accepted values: | Csv, Text |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TraceLevel
Indique quelles données sont collectées et enregistrées dans le fichier de trace. Les valeurs possibles sont 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
Spécifie le nombre de secondes pendant lesquelles le moteur Analysis Services attend avant de terminer la trace (si vous spécifiez le paramètre -TraceFile).
Une trace est considérée terminée si aucun message de trace n'a été enregistré au cours de la période spécifiée.
La valeur de délai d'attente de la trace par défaut est de 5 secondes.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Variables
Spécifie des variables de script supplémentaires. Chaque variable est une paire nom-valeur. Si la valeur contient des espaces ou des caractères de contrôle incorporés, elle doit figurer entre guillemets doubles. Utilisez un tableau PowerShell pour spécifier plusieurs variables et les valeurs correspondantes.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
PSObject
Sorties
string
Notes
Pris en charge sur toutes les instances Analysis Services, y compris PowerBI Premium