Invoke-ASCmd

  • Référence
Module:
SQLServer

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