Invoke-ASCmd
Memungkinkan administrator database 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
[-ProgressAction <ActionPreference>]
[-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>]
[-ProgressAction <ActionPreference>]
[-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>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-ASCmd
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-ASCmd
[-Server <String>]
[-Credential <PSCredential>]
[-ServicePrincipal]
[-ApplicationId <String>]
[-TenantId <String>]
[-CertificateThumbprint <String>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Memungkinkan administrator database 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, Menyinkronkan, 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 penemuan 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.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-CertificateThumbprint
Thumbprint sertifikat untuk perwakilan layanan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Jenis: | SwitchParameter |
Alias: | cf |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Credential
Jika parameter ini ditentukan, nama pengguna dan kata sandi yang diteruskan akan digunakan untuk menyambungkan ke instans Analysis Server yang ditentukan. Jika tidak ada kredensial yang ditentukan akun windows default pengguna yang menjalankan alat akan digunakan.
Jenis: | PSCredential |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-InputFile
Mengidentifikasi file yang berisi skrip XMLA, kueri MDX, pernyataan DMX, atau skrip TMSL (di JSON). Anda harus menentukan nilai untuk InputFile
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ProgressAction
Menentukan bagaimana PowerShell merespons pembaruan kemajuan yang dihasilkan oleh skrip, cmdlet, atau penyedia, seperti bilah kemajuan yang dihasilkan oleh cmdlet Write-Progress. cmdlet Write-Progress membuat bilah kemajuan yang memperlihatkan status perintah.
Jenis: | ActionPreference |
Alias: | proga |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Query
Menentukan skrip, kueri, atau pernyataan aktual langsung pada baris perintah alih-alih dalam file.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-Server
Secara opsional menentukan instans server yang akan disambungkan jika saat ini tidak berada di direktori Penyedia SQLAS.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-ServicePrincipal
Menentukan bahwa koneksi ini menggunakan perwakilan layanan.
Jenis: | SwitchParameter |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TenantId
Id penyewa untuk perwakilan layanan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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 dihasilkan.
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TraceFileDelimiter
Menentukan satu karakter sebagai pembatas file pelacakan saat Anda menentukan csv sebagai format untuk file pelacakan yang menggunakan parameter -TraceFileFormat.
Defaultnya adalah | (pipa, atau bilah vertikal).
Jenis: | String |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TraceFileFormat
Menentukan format file untuk parameter -TraceFile (jika parameter ini ditentukan).
Nilai defaultnya adalah "Csv".
Jenis: | TraceFileFormatOption |
Nilai yang diterima: | Csv, Text |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-TraceLevel
Menentukan data apa yang dikumpulkan dan direkam dalam file pelacakan. Nilai yang mungkin adalah Tinggi, Sedang, Rendah, Durasi, DurasiResult.
Jenis: | TraceLevelOption |
Nilai yang diterima: | High, Medium, Low, Duration, DurationResult |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | Int32 |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | 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.
Jenis: | String[] |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Jenis: | SwitchParameter |
Alias: | wi |
Position: | Named |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | False |
Terima karakter wildcard: | False |
Input
PSObject
Output
string
Catatan
Didukung pada semua instans Analysis Services termasuk PowerBI Premium