Invoke-ASCmd

Modul:

SQLServer

Ermöglicht Datenbankadministratoren das Ausführen eines XMLA-Skripts, eines TMSL-Skripts, einer DAX-Abfrage (Data Analysis Expressions), einer MDX-Abfrage (Multidimensional Expressions) oder einer DMX-Anweisung (Data Mining Extensions) für eine instance von 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>]

Beschreibung

Ermöglicht Datenbankadministratoren das Ausführen eines XMLA-Skripts, eines TMSL-Skripts, einer DAX-Abfrage (Data Analysis Expressions), einer MDX-Abfrage (Multidimensional Expressions) oder einer DMX-Anweisung (Data Mining Extensions) für eine instance von Analysis Services.

Die Cmdlets führen diese Abfragen oder Skripts in Eingabedateien aus.

Das übergebene Skript ist ein XMLA-Befehl, und die folgenden Befehle werden unterstützt: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (wird zum Ausführen von MDX-Abfragen und DMX-Anweisungen verwendet), Subscribe, Synchronize, Unlock, UpdateCells.

Dieses Skript akzeptiert auch JSON-Befehle, die für die Ausführung für eine tabellarische Datenbank mit dem Kompatibilitätsmodus 1200 oder höher entwickelt wurden.

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

Beispiele

Aufrufen der Ermittlung

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

Aufrufen von 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>"

Aufrufen der Auswahl

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

Aufrufen von Select 2

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

Aufrufen mit xmla-Datei

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>

#>

Parameter

-ApplicationId

Die Anwendungs-ID für den Dienstprinzipal.

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

-CertificateThumbprint

Der Zertifikatfingerabdruck für den Dienstprinzipal.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-ConnectionString

Gibt die Verbindungszeichenfolge an.

Beachten Sie, dass andere Eigenschaften auf Verbindungsebene wie Server, Datenbank usw. werden ignoriert, wenn diese Eigenschaft angegeben wird und daher diese Eigenschaften in die Verbindungszeichenfolge eingeschlossen werden müssen.

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

-ConnectionTimeout

Gibt die Anzahl von Sekunden an, bevor das Timeout der Verbindung mit analysis Services instance. Der Timeoutwert muss eine ganze Zahl zwischen 0 und 65534 sein. Wenn 0 angegeben wird, verursachen Verbindungsversuche kein Timeout.

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

-Credential

Wenn dieser Parameter angegeben wird, werden der übergebene Benutzername bzw. das übergebene Kennwort verwendet, um eine Verbindung mit der angegebenen Analysis-Server-Instanz herzustellen. Wenn keine Anmeldeinformationen angegeben sind, wird das Standard-Windows-Konto des Benutzers, der das Tool ausführt, verwendet.

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

-Database

Gibt die Datenbank an, für die eine MDX-Abfrage oder eine DMX-Anweisung ausgeführt wird. Der database-Parameter wird ignoriert, wenn das Cmdlet ein XMLA-Skript ausführt, da in XMLA-Skripts der Datenbankname bereits eingebettet ist.

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

-InputFile

Gibt die Datei an, in der das XMLA-Skript, die MDX-Abfrage, die DMX-Anweisung bzw. das TMSL-Skript (in JSON) enthalten ist. Sie müssen einen Wert für den Parameter InputFile oder *Query *angeben, wenn Sie Invoke-AsCmd verwenden.

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

-Query

Gibt das eigentliche Skript, die Abfrage oder die Anweisung direkt an der Befehlszeile und nicht in einer Datei an.

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

-QueryTimeout

Gibt die Anzahl von Sekunden vor dem Timeout der Abfragen an. Wenn kein Timeoutwert angegeben wird, wird für die Abfragen kein Timeout ausgeführt. Das Timeout muss eine ganze Zahl zwischen 1 und 65535 sein.

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

-Server

Gibt optional den Server instance an, mit dem eine Verbindung hergestellt werden soll, wenn sich dies derzeit nicht im SQLAS-Anbieterverzeichnis befindet.

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

-ServicePrincipal

Gibt an, dass diese Verbindung den Dienstprinzipal verwendet.

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

-TenantId

Die Mandanten-ID für den Dienstprinzipal.

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

-TraceFile

Identifiziert eine Datei, die Analysis Services-Ablaufverfolgungsereignisse beim Ausführen des XMLA-Skripts, der MDX-Abfrage oder der DMX-Anweisung empfängt. Wenn die Datei bereits vorhanden ist, wird sie automatisch überschrieben (mit Ausnahme der Ablaufverfolgungsdateien, die mithilfe der Parametereinstellungen -TraceLevel:Duration und -TraceLevel:DurationResult erstellt werden).

Dateinamen, die Leerzeichen enthalten, müssen in Anführungszeichen ("") eingeschlossen werden.

Wenn der Dateiname ungültig ist, wird eine Fehlermeldung generiert.

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

-TraceFileDelimiter

Gibt ein einzelnes Zeichen als Trennzeichen für die Ablaufverfolgungsdatei an, wenn Sie csv als Format für die Ablaufverfolgungsdatei angeben, die den Parameter -TraceFileFormat verwendet.

Standardmäßig wird | (Pipezeichen oder senkrechter Strich) verwendet.

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

-TraceFileFormat

Gibt das Dateiformat für den Parameter -TraceFile an (wenn dieser Parameter angegeben ist).

Der Standardwert ist "Csv".

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

-TraceLevel

Gibt an, welche Daten in der Ablaufverfolgungsdatei gesammelt und aufgezeichnet werden. Mögliche Werte sind 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

Gibt die Anzahl der Sekunden an, die das Analysis Services-Modul wartet, bevor die Ablaufverfolgung beendet wird (wenn Sie den Parameter -TraceFile angeben).

Die Ablaufverfolgung gilt als beendet, wenn während des angegebenen Zeitraums keine Meldungen zur Ablaufverfolgung aufgezeichnet wurden.

Standardmäßig beträgt der Timeoutwert für die Ablaufverfolgung 5 Sekunden.

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

-Variables

Gibt zusätzliche Skriptvariablen an. Jede Variable besteht aus einem Name-Wert-Paar. Wenn der Wert eingebettete Leerzeichen oder Steuerzeichen enthält, muss er in doppelte Anführungszeichen eingeschlossen werden. Verwenden Sie ein PowerShell-Array, um mehrere Variablen und ihre Werte anzugeben.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

PSObject

Ausgaben

string

Hinweise

Unterstützt für alle Analysis Services-Instanzen, einschließlich PowerBI Premium