Bagikan melalui

Invoke-ASCmd

  • Referensi
Modul:
SQLServer

Memungkinkan administrator database untuk menjalankan skrip XMLA, skrip TMSL, kueri Data Analysis Expressions (DAX), kueri Ekspresi Multidimensi (MDX), atau pernyataan Ekstensi Penggalian Data (DMX) terhadap instans Analysis Services.

Sintaks

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

Deskripsi

Memungkinkan administrator database untuk menjalankan skrip XMLA, skrip TMSL, kueri Data Analysis Expressions (DAX), kueri Ekspresi Multidimensi (MDX), atau pernyataan Ekstensi Penggalian Data (DMX) terhadap instans Analysis Services.

Cmdlet eksekusi kueri atau skrip ini dalam file input.

Skrip yang diteruskan adalah perintah XMLA dan perintah berikut didukung: Ubah, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (digunakan untuk menjalankan kueri MDX dan pernyataan DMX), Berlangganan, Synchronize, Unlock, Update, UpdateCells.

Skrip ini juga akan menerima perintah JSON yang dirancang untuk dijalankan terhadap database tabular dengan mode kompatibilitas 1200 atau lebih tinggi.

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

Contoh

Panggil penemuan

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

Panggil temukan 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>"

Panggil pilih

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

Panggil pilih 2

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

Memanggil dengan file 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>

#>

Parameter

-ApplicationId

Id aplikasi untuk perwakilan layanan.

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

-CertificateThumbprint

Thumbprint sertifikat untuk perwakilan layanan.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-ConnectionString

Menentukan string koneksi.

Perhatikan bahwa properti tingkat koneksi lainnya seperti Server, Database, dll. diabaikan ketika properti ini ditentukan dan oleh karena itu properti ini harus disertakan dalam string koneksi.

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

-ConnectionTimeout

Menentukan jumlah detik sebelum koneksi ke instans Analysis Services kehabisan waktu. Nilai batas waktu harus berupa bilangan bulat antara 0 dan 65534. Jika 0 ditentukan, upaya koneksi tidak kehabisan waktu.

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

-Credential

Jika parameter ini ditentukan, nama pengguna dan kata sandi yang diteruskan akan digunakan untuk menyambungkan ke instans Analysis Server tertentu. Jika tidak ada kredensial yang ditentukan akun windows default pengguna yang menjalankan alat akan digunakan.

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

-Database

Menentukan database tempat kueri MDX atau pernyataan DMX akan dijalankan. Parameter database diabaikan ketika cmdlet menjalankan skrip XMLA, karena nama database disematkan dalam skrip XMLA.

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

-InputFile

Mengidentifikasi file yang berisi skrip XMLA, kueri MDX, pernyataan DMX, atau skrip TMSL (di JSON). Anda harus menentukan nilai untuk InputFile atau parameter *Kueri *saat menggunakan Invoke-AsCmd.

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

-Query

Menentukan skrip, kueri, atau pernyataan aktual langsung pada baris perintah alih-alih dalam file.

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

-QueryTimeout

Menentukan jumlah detik sebelum waktu kueri habis. Jika nilai batas waktu tidak ditentukan, kueri tidak kehabisan waktu. Batas waktu harus berupa bilangan bulat antara 1 dan 65535.

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

-Server

Secara opsional menentukan instans server yang akan disambungkan jika saat ini tidak berada di direktori Penyedia SQLAS.

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

-ServicePrincipal

Menentukan bahwa koneksi ini menggunakan perwakilan layanan.

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

-TenantId

Id penyewa untuk perwakilan layanan.

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

-TraceFile

Mengidentifikasi file yang menerima peristiwa pelacakan Analysis Services saat menjalankan skrip XMLA, kueri MDX, atau pernyataan DMX. Jika file sudah ada, file secara otomatis ditimpa (kecuali untuk file jejak yang dibuat dengan menggunakan pengaturan parameter -TraceLevel:Duration dan -TraceLevel:DurationResult).

Nama file yang berisi spasi harus diapit dalam tanda kutip ("").

Jika nama file tidak valid, pesan kesalahan akan dibuat.

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

-TraceFileDelimiter

Menentukan karakter tunggal sebagai pemisah file pelacakan saat Anda menentukan csv sebagai format untuk file pelacakan yang menggunakan parameter -TraceFileFormat.

Defaultnya adalah | (pipa, atau bilah vertikal).

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

-TraceFileFormat

Menentukan format file untuk parameter -TraceFile (jika parameter ini ditentukan).

Nilai defaultnya adalah "Csv".

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

-TraceLevel

Menentukan data apa yang dikumpulkan dan direkam dalam file pelacakan. Nilai yang mungkin adalah Tinggi, Sedang, Rendah, Durasi, DurasiResult.

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

Menentukan jumlah detik yang ditunggu mesin Analysis Services sebelum mengakhiri jejak (jika Anda menentukan parameter -TraceFile).

Jejak dianggap selesai jika tidak ada pesan jejak yang direkam selama periode waktu yang ditentukan.

Nilai batas waktu pelacakan default adalah 5 detik.

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

-Variables

Menentukan variabel pembuatan skrip tambahan. Setiap variabel adalah pasangan nama-nilai. Jika nilai berisi spasi atau karakter kontrol yang disematkan, nilai harus diapit dalam tanda kutip ganda. Gunakan array PowerShell untuk menentukan beberapa variabel dan nilainya.

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

-WhatIf

Menunjukkan yang akan terjadi jika cmdlet dijalankan. Cmdlet tidak dijalankan.

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

Input

PSObject

Output

string

Catatan

Didukung pada semua instans Analysis Services termasuk PowerBI Premium