Invoke-ASCmd cmdlet

使数据库管理员能够执行 XMLA 脚本、多维表达式 (MDX) 或数据挖掘扩展插件 (DMX) 语句。

语法

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

说明

Invoke-ASCmd cmdlet 可以执行在输入文件中包含的查询或脚本。 支持以下命令：Alter、Backup、Batch、BeginTransaction、Cancel、ClearCache、CommitTransaction、 Create、Delete、DesignAggregations、Drop、Insert、Lock、MergePartitions、NotifyTableChange、Process、Restore、RollbackTransaction、Statement（用于执行 MDX 查询和 DMX 语句）、Subscribe、Synchronize、Unlock、Update、UpdateCells。

此 cmdlet 支持 –Credential 参数，该参数可在您配置 Analysis Services 实例以进行 HTTP 访问时使用。 –Credential 参数具有可提供 Windows 用户标识的 PSCredential 对象。 之后，IIS 将在连接到 Analysis Services 时模拟该用户。 此标识必须对 Analysis Services 实例具有系统管理员权限才能运行脚本。

参数

-Query <string>

直接在命令行中（而不是文件中）指定实际脚本、查询或语句。 也可以将查询指定为管道输入。 在使用 Invoke-AsCmd 时，必须为 –InputFile 或 –Query 参数指定值。

-InputFile <string>

标识包含 XMLA 脚本、MDX 查询或 DMX 语句的文件。 在使用 Invoke-AsCmd 时，必须为 –InputFile 或 –Query 参数指定值。

-Server <string>

指定 cmdlet 要连接和执行的 Analysis Services 实例。 如果未提供服务器名称，将连接到本地主机。 对于默认实例，仅指定服务器名称。 对于命名实例，请使用格式 servername\instancename。 对于 HTTP 连接，请使用格式 http[s]://server[:port]/virtualdirectory/msmdpump.dll。

-Database <string>

指定要对其执行 MDX 查询或 DMX 语句的数据库。 当 cmdlet 执行 XMLA 脚本时，将忽略 database 参数，因为数据库名称嵌入在 XMLA 脚本之中。

-Credential <PSCredential>

指定可提供 Windows 用户名和密码的 PSCredential 对象。 仅当配置 Analysis Services 实例以使用基本身份验证进行 HTTP 访问时指定此参数。 对于使用集成安全性的本机连接，将忽略此参数。

如果此参数存在，则将其提供的凭据追加到连接字符串。 IIS 将在连接到 Analysis Services 时模拟该用户标识。 如果未指定凭据，将使用正在运行该工具的用户的默认 Windows 帐户。

若要使用此参数，请首先使用 Get-Credential 创建一个 PSCredential 对象，以便指定用户名和密码（例如 $Cred=Get-Credential “adventure-works\admin”）。 然后，可以将此对象传送到 –Credential 参数 (-Credential:$Cred)。

有关身份验证和凭据使用的详细信息，请参阅 Analysis Services PowerShell。 有关 HTTP 访问的详细信息，请参阅配置对 Internet Information Services (IIS) 7.0 上 Analysis Services 的 HTTP 访问。

-ConnectionTimeout <int>

指定连接到 Analysis Services 实例超时之前等待的秒数。 超时值必须是 0 和 65534 之间的整数。 如果指定 0，则连接尝试将不会超时。

-QueryTimeout <int>

指定查询超时之前等待的秒数。 如果未指定超时值，则查询将不会超时。 超时值必须是 1 和 65535 之间的整数。

-Variable <string[]>

指定其他脚本变量。 每个变量都是一个名称-值对。 如果值中包含嵌入的空格或控制字符，则必须使用双引号 (") 将其引起来。 使用 PowerShell 数组可指定多个变量及其值。

-TraceFile <string>

标识在执行 XMLA 脚本、MDX 查询或 DMX 语句时将接收 Analysis Services 跟踪事件的文件。 如果该文件已存在，则自动将其覆盖（但使用 -TraceLevel:Duration 和 –TraceLevel:DurationResult 参数设置创建的跟踪文件除外）。 包含空格的文件名必须用引号 (" ") 引起来。 如果文件名无效，将生成一个错误消息。

-TraceFileFormat <string>

指定 –TraceFile 参数的文件格式（如果指定了该参数）。 可用选项为文本或 csv。 默认值为“csv”。

-TraceFileDelimiter <string>

指定在将 csv 指定为跟踪文件格式时要用作跟踪文件分隔符的字符。 默认值为 |（竖线）。

-TraceTimeout <int>

指定结束跟踪之前 Analysis Services 引擎等待的秒数（如果指定了 –TraceFile 参数）。 如果在指定时间段没有记录跟踪消息，则认为跟踪已完成。 默认跟踪超时值为 5 秒。

-TraceLevel <TraceLevelOption>

指定在跟踪文件中收集和记录哪些数据。 可能值为 High、Medium、Low、Duration、DurationResult。

<CommonParameters>

此 cmdlet 支持以下常用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。 有关详细信息，请参阅 About_CommonParameters。

输入和输出

输入类型是可以传送到 cmdlet 的对象的类型。 返回类型是 cmdlet 所返回的对象的类型。

示例 1

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

此命令运行一个 XMLA 脚本，该脚本返回服务器上活动连接的列表。 文件 DiscoverConnections.xmla 包含以下 XMLA 脚本：

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

<Restrictions />

<Properties>

<PropertyList>

<Content>Data</Content>

</PropertyList>

</Properties>

</Discover>

示例 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>"

发现 XMLA 查询将返回可用于分析服务器的数据源以及连接到这些数据源所需的信息。 结果采用 XML 格式。 为改进可读性，您可以将输出传输到一个 XML 文件（例如，将 | Out-file C:\Results\XMLAQueryOutput.xml 追加到该命令），然后在浏览器或支持结构化 XML 的其他应用程序中查看结果。

请参阅

概念

Analysis Services PowerShell

其他资源

使用 PowerShell 管理表格模型