Invoke-ASCmd-Cmdlet

Ermöglicht Datenbankadministratoren XMLA-Skripts, MDX-Abfragen (Multidimensional Expressions) oder DMX-Anweisungen (Data Mining Extensions) auszuführen.

Syntax

Invoke-ASCmd –Query <string> [-Server <string>] [-Database <string>] [-Credential <PSCredential>] [-ConnectionTimeout <int>] [-QueryTimeout <int>] [-Variable <string[]>] [-TraceFile <string>] [-TraceFileFormat <TraceFileFormatOption>] [-TraceFileDelimiter <string>] [-TraceTimeout <int>] [-TraceLevel <TraceLevelOption>] [<CommonParameters>]

Invoke-ASCmd –InputFile <string> [-Server <string>] [-Database <string>] [-Credential <PSCredential>] [-ConnectionTimeout <int>] [-QueryTimeout <int>] [-Variable <string[]>] [-TraceFile <string>] [-TraceFileFormat <TraceFileFormatOption>] [-TraceFileDelimiter <string>] [-TraceTimeout <int>] [-TraceLevel <TraceLevelOption>] [<CommonParameters>]

Beschreibung

Das Invoke-ASCmd-Cmdlet kann Abfragen oder Skripts ausführen, die in Eingabedateien enthalten sind. 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 (zum Ausführen von MDX-Abfragen und DMX-Anweisungen), Subscribe, Synchronize, Unlock, Update, UpdateCells.

Dieses Cmdlet unterstützt den –Credential-Parameter, der verwendet werden kann, wenn Sie die Analysis Services-Instanz für HTTP-Zugriff konfigurierten. Der –Credential-Parameter verwendet ein PSCredential-Objekt, das eine Windows-Benutzeridentität bereitstellt. Beim Herstellen einer Verbindung mit Analysis Services nimmt wird die Identität dieses Benutzers dann von IIS angenommen. Die Identität muss über Systemadministratorberechtigungen für die Analysis Services-Instanz verfügen, um ein Skript ausführen zu können.

Parameter

-Query <string>

Gibt das eigentliche Skript, die Abfrage oder die Anweisung direkt an der Befehlszeile und nicht in einer Datei an. Sie können auch eine Abfrage als Pipelineeingabe angeben. Sie müssen einen Wert für den –InputFile-Parameter oder für den –Query-Parameter angeben, wenn Sie Invoke-AsCmd verwenden.

-InputFile <string>

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

-Server <string>

Gibt die Analysis Services-Instanz an, zu der das Cmdlet eine Verbindung herstellt und auf der es ausgeführt wird. Wenn kein Servername angegeben wird, wird eine Verbindung mit localhost hergestellt. Für Standardinstanzen geben Sie nur den Servernamen an. Verwenden Sie für benannte Instanzen das Format "servername\instanzenname". Verwenden Sie für HTTP-Verbindungen das Format "http[s]://server[:port]/virtualdirectory/msmdpump.dll".

-Database <string>

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.

-Credential <PSCredential>

Gibt ein PSCredential-Objekt an, das einen Windows-Benutzernamen und ein -Kennwort angegeben werden. Geben Sie diesen Parameter nur an, wenn die Analysis Services-Instanz mit der Standardauthentifizierung für HTTP-Zugriff konfiguriert wird. Für systemeigene Verbindungen, die integrierte Sicherheit verwenden, wird dieser Parameter ignoriert.

Wenn dieser Parameter vorhanden ist, werden die Anmeldeinformationen, die es bereitstellt, an die Verbindungszeichenfolge angefügt. Beim Herstellen einer Verbindung mit Analysis Services wird die Identität dieses Benutzers dann von IIS angenommen. Wenn keine Anmeldeinformationen angegeben sind, wird das Windows-Standardkonto des Benutzers, der das Tool ausführt, verwendet.

Um diesen Parameter zu verwenden, erstellen Sie zuerst mit Get-Credential ein PSCredential-Objekt, um den Benutzernamen und das Kennwort anzugeben (z. B. $Cred=Get-Credential “adventure-works\admin”). Sie können dann dieses Objekt an den –Credential-Parameter (-Credential:$Cred weitergeben.

Weitere Informationen über Authentifizierung und die Verwendung von Anmeldeinformationen finden Sie unter Analysis Services PowerShell. Weitere Informationen zum HTTP-Zugriff finden Sie unter Konfigurieren von HTTP-Zugriff auf Analysis Services unter Internetinformationsdienste (IIS) 7.0.

-ConnectionTimeout <int>

Gibt an, nach wie vielen Sekunden bei der Verbindung mit der Analysis Services-Instanz ein Timeout auftritt. Der Timeoutwert muss einer ganzen Zahl zwischen 0 und 65534 entsprechen. Wenn 0 angegeben werden, erfolgt kein Timeout der Verbindungsversuche.

-QueryTimeout <int>

Gibt an, nach wie vielen Sekunden ein Timeout bei Abfragen auftritt. Wenn Sie keinen Timeoutwert angeben, erfolgt für Abfragen kein Timeout. Der Timeoutwert muss einer ganzen Zahl zwischen 1 und 65535 entsprechen.

-Variable <string[]>

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.

-TraceFile <string>

Identifiziert beim Ausführen eines XMLA-Skripts, einer MDX-Abfrage oder einer DMX-Anweisung eine Datei, die Analysis Services-Ablaufverfolgungsereignisse empfängt. Wenn die Datei bereits vorhanden ist, wird sie automatisch überschrieben (mit Ausnahme der Ablaufverfolgungsdateien, die mit den Parametereinstellungen -TraceLevel:Duration und –TraceLevel:DurationResult erstellt wurden). (Ablaufverfolgungsdateien, die mit der Parametereinstellung '–TraceLevel:Duration' und '–TraceLevel:DurationResult' erstellt werden, sind hiervon ausgenommen.) Dateinamen mit Leerzeichen müssen in Anführungszeichen (" ") eingeschlossen werden. Wenn der Dateiname ungültig ist, wird eine Fehlermeldung generiert.

-TraceFileFormat <string>

Gibt das Dateiformat für den –TraceFile-Parameter an (falls dieser Parameter angegeben wird). Die verfügbaren Optionen sind "Text" oder "csv". Der Standardwert ist ".csv".

-TraceFileDelimiter <string>

Gibt an, welches Zeichen als Trennzeichen für die Ablaufverfolgungsdatei verwendet wird, wenn "csv" als Format für die Ablaufverfolgungsdatei angegeben wird. Standardmäßig wird | (Pipezeichen oder senkrechter Strich) verwendet.

-TraceTimeout <int>

Gibt an, wie viele Sekunden das Analysis Services-Modul wartet, bevor die Ablaufverfolgung beendet wird (wenn der –TraceFile-Parameter angegeben wird). 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.

-TraceLevel <TraceLevelOption>

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

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter About_CommonParameters.

Eingaben und Ausgaben

Mit dem Eingabetyp wird festgelegt, welchen Typ von Objekten Sie über die Pipeline an das Cmdlet übergeben können. Der Rückgabetyp bezeichnet den Typ der vom Cmdlet zurückgegebenen Objekte.

Beispiel 1

Invoke-ASCmd –InputFile:”C:\MyFolder\DiscoverConnections.xmla”

Dieser Befehl führt ein XMLA-Skript aus, das die Liste der aktiven Verbindungen auf dem Server zurückgibt. Die Datei" DiscoverConnections.xmla" enthält das folgende XMLA-Skript:

<Discover xmlns="urn:schemas-microsoft-com:xml-analysis">
<RequestType>DISCOVER_CONNECTIONS</RequestType>

<Restrictions />

<Properties>

<PropertyList>

<Content>Data</Content>

</PropertyList>

</Properties>

</Discover>

Beispiel 2

Invoke-ASCmd -Database:"Adventure Works DW" -Query:"<Discover xmlns='urn:schemas-microsoft-com:xml analysis'><RequestType>DISCOVER_DATASOURCES</RequestType><Restrictions></Restrictions><Properties></Properties></Discover>"

Die Discover XMLA-Abfrage gibt verfügbare Datenquellen für den Analysis-Server zurück, sowie die Informationen, die erforderlich sind, um eine Verbindung mit ihnen herzustellen. Die Ergebnisse werden in XML angegeben. Für verbesserte Lesbarkeit können Sie die Ausgabe an eine XML-Datei übergeben (fügen Sie dem Befehl z. B. | Out-file C:\Results\XMLAQueryOutput.xml) und die Ergebnisse in einem Browser oder anderer Anwendung anzeigen, die strukturiertes XML unterstützt.

Siehe auch

Konzepte

Analysis Services PowerShell

Andere Ressourcen

Verwalten von tabellarischen Modellen mit PowerShell