Invoke-ASCmd-Cmdlet

Artikel
05/07/2013

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.

Erforderlich?	true
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	True (ByValue)
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	true
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert	localhost
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	True (ByValue)
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert	30
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert	30
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-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). Dateinamen, die Leerzeichen enthalten, müssen in Anführungszeichen (" ") eingeschlossen werden. Wenn der Dateiname ungültig ist, wird eine Fehlermeldung generiert.

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert	csv
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Erforderlich?	false
Position?	benannt
Standardwert	5
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-TraceLevel <TraceLevelOption>

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

Erforderlich?	false
Position?	benannt
Standardwert	High
Pipelineeingabe akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

Eingaben	PSObject
Ausgaben	Zeichenfolge

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.

Freigeben über