Freigeben über

Invoke-ASCmd

  • Referenz
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 DATA Mining Extensions -Anweisung (DATA Mining Extensions) für eine Instanz von Analysis Services.

Syntax

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

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 DATA Mining Extensions -Anweisung (DATA Mining Extensions) für eine Instanz 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 (verwendet zum Ausführen von MDX-Abfragen und XML-Anweisungen), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Dieses Skript akzeptiert auch JSON-Befehle, die für die Ausführung für eine tabellarische Datenbank mit 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 Erkennung

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

Aufrufen der Ermittlung 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>"

Auswahl aufrufen

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 "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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CertificateThumbprint

Der Zertifikatfingerabdruck für den Dienstprinzipal.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConnectionString

Gibt die Verbindungszeichenfolge an.

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConnectionTimeout

Gibt die Anzahl von Sekunden an, bevor die Verbindung mit der Analysis Services-Instanz zu einem Zeitüberschreitungsausfall erfolgt. Der Timeoutwert muss eine ganze Zahl zwischen 0 und 65534 sein. Wenn 0 angegeben ist, werden Verbindungsversuche nicht unterbrochen.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Wenn dieser Parameter angegeben ist, wird der übergebene Benutzername und das Kennwort verwendet, um eine Verbindung mit der angegebenen Analysis Server-Instanz herzustellen. Wenn keine Anmeldeinformationen für das Standardfensterkonto des Benutzers angegeben werden, der das Tool ausführt, wird verwendet.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Database

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputFile

Gibt die Datei an, die das XMLA-Skript, die MDX-Abfrage, DIE ANWEISUNG ODER das TMSL-Skript (in JSON) enthält. Sie müssen einen Wert für die InputFile- oder den *Query *-Parameter angeben, wenn Sie Invoke-AsCmd verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:ActionPreference
Aliase:proga
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Query

Gibt das tatsächliche Skript, die Abfrage oder anweisung direkt in der Befehlszeile statt in einer Datei an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-QueryTimeout

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

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Server

Gibt optional die Serverinstanz an, mit der eine Verbindung hergestellt werden soll, wenn sie sich derzeit nicht im SQLAS-Anbieterverzeichnis befindet.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServicePrincipal

Gibt an, dass diese Verbindung den Dienstprinzipal verwendet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TenantId

Die Mandanten-ID für den Dienstprinzipal.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TraceFile

Identifiziert eine Datei, die Analysis Services-Ablaufverfolgungsereignisse empfängt, während sie das XMLA-Skript, die MDX-Abfrage oder die ASPX-Anweisung ausführen. 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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Der Standardwert ist | (Rohr oder vertikaler Balken).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TraceFileFormat

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

Der Standardwert ist "CSV".

Typ:TraceFileFormatOption
Zulässige Werte:Csv, Text
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TraceLevel

Gibt an, welche Daten in der Ablaufverfolgungsdatei gesammelt und aufgezeichnet werden. Mögliche Werte sind "High", "Medium", "Low", "DurationResult".

Typ:TraceLevelOption
Zulässige Werte:High, Medium, Low, Duration, DurationResult
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 wird als abgeschlossen betrachtet, wenn während des angegebenen Zeitraums keine Ablaufverfolgungsmeldungen aufgezeichnet wurden.

Der Standardmäßige Timeoutwert der Ablaufverfolgung beträgt 5 Sekunden.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Variables

Gibt zusätzliche Skriptingvariablen an. Jede Variable ist ein 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 deren Werte anzugeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSObject

Ausgaben

string

Hinweise

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