Invoke-ASCmd

  • 參考
模組:
SQLServer

可讓資料庫管理員針對 Analysis Services 實例執行 XMLA 腳本、TMSL 腳本、資料分析運算式 (DAX) 查詢、多維度運算式 (MDX) 查詢 (，或針對 Analysis Services 實例執行 DMX) 語句。

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

Description

可讓資料庫管理員針對 Analysis Services 實例執行 XMLA 腳本、TMSL 腳本、資料分析運算式 (DAX) 查詢、多維度運算式 (MDX) 查詢 (，或針對 Analysis Services 實例執行 DMX) 語句。

Cmdlet 會在輸入檔內執行這些查詢或腳本。

傳遞的腳本是 XMLA 命令，且支援下列命令：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。

此腳本也會接受 JSON 命令，其設計目的是針對相容性模式為 1200 或更高版本的表格式資料庫執行。

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

範例

叫用探索

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

叫用選取

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

叫用選取 2

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

使用 xmla 檔案叫用

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>

#>

參數

-ApplicationId

服務主體的應用程式識別碼。

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

-CertificateThumbprint

服務主體的憑證指紋。

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

-Confirm

在執行 Cmdlet 前提示您確認。

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

-ConnectionString

指定連接字串。

請注意，其他連接層級屬性，例如伺服器、資料庫等。指定這個屬性時會忽略，因此這些屬性必須包含在連接字串中。

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

-ConnectionTimeout

指定與 Analysis Services 實例連接逾時之前的秒數。逾時值必須是介於 0 到 65534 之間的整數。 如果指定了 0，連線嘗試就不會逾時。

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

-Credential

如果指定了此參數，傳遞的使用者名稱和密碼將會用來連接到指定的 Analysis Server 執行個體。 如果沒有指定認證，則會使用執行此工具之使用者的預設 Windows 帳戶。

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

-Database

指定將會對其執行 MDX 查詢或 DMX 陳述式的資料庫。 因為資料庫名稱是內嵌在 XMLA 指令碼中，所以當指令程式執行 XMLA 指令碼時，系統會忽略資料庫參數。

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

-InputFile

識別包含了 XMLA 指令碼、MDX 查詢、DMX 陳述式或 TMSL 指令碼 (JSON 中) 的檔案。 使用 Invoke-AsCmd 時，您必須指定 InputFile 或 *Query *參數的值。

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

-Query

直接在命令列上 (而不是檔案中) 指定實際指令碼、查詢或陳述式。

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

-QueryTimeout

指定查詢逾時之前的秒數。如果未指定逾時值，查詢就不會逾時。逾時必須是介於 1 到 65535 之間的整數。

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

-Server

選擇性地指定要在 SQLAS 提供者目錄中目前未連線的伺服器實例。

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

-ServicePrincipal

指定此連線使用服務主體。

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

-TenantId

服務主體的租使用者識別碼。

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

-TraceFile

識別執行 XMLA 指令碼、MDX 查詢或 DMX 陳述式時接收 Analysis Services 追蹤事件的檔案。 如果檔案已經存在，系統會自動覆寫 (，但使用 -TraceLevel：Duration 和 -TraceLevel：DurationResult 參數設定) 所建立的追蹤檔案除外。

包含空格的檔案名必須以引號括住 (「」) 。

如果檔案名稱無效，則會產生一則錯誤訊息。

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

-TraceFileDelimiter

當您指定 csv 做為使用 -TraceFileFormat 參數之追蹤檔案的格式時，指定單一字元做為追蹤檔案分隔符號。

預設值是 | (直立線符號或分隔號)。

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

-TraceFileFormat

如果指定此參數) ，則指定 -TraceFile 參數的檔案格式 (。

預設值為 「Csv」。

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

-TraceLevel

指定追蹤檔中要收集和記錄的資料。 可能的值包括 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

指定如果您指定 -TraceFile 參數) ，Analysis Services 引擎在結束追蹤 (之前等候的秒數。

如果在指定的時間週期內沒有記錄追蹤訊息，追蹤會被視為已完成。

預設的追蹤逾時值是 5 秒。

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

-Variables

指定其他指令碼變數。 每個變數都是名稱/值組。 如果此值包含內嵌空格或控制字元，就必須以雙引號括住。 您可以使用 PowerShell 陣列來指定多個變數及其值。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

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

輸入

PSObject

輸出

string

備註

支援所有 Analysis Services 實例，包括 PowerBI Premium