Invoke-ASCmd
Позволяет администраторам базы данных выполнять скрипт XMLA, скрипт TMSL, запросы выражений анализа данных (DAX), многомерные выражения (многомерные выражения) или инструкцию расширений интеллектуального анализа данных (DMX) для экземпляра служб Analysis Services.
Синтаксис
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>]Описание
Позволяет администраторам базы данных выполнять скрипт XMLA, скрипт TMSL, запросы выражений анализа данных (DAX), многомерные выражения (многомерные выражения) или инструкцию расширений интеллектуального анализа данных (DMX) для экземпляра служб Analysis Services.
Командлеты выполнения этих запросов или скриптов в входных файлах.
Переданный скрипт является командой XMLA и поддерживаются следующие команды: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement (используется для выполнения запросов многомерных выражений и инструкций DMX), Подписки, Синхронизация, Разблокировка, Обновление, 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
Идентификатор приложения для субъекта-службы.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CertificateThumbprint
Отпечаток сертификата для субъекта-службы.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском командлета.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ConnectionString
Указывает строку подключения.
Обратите внимание, что другие свойства уровня подключения, такие как Сервер, База данных и т. д., игнорируются при указании этого свойства, поэтому эти свойства должны быть включены в строку подключения.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ConnectionTimeout
Указывает количество секунд до истечения времени ожидания подключения к экземпляру служб Analysis Services. Значение времени ожидания должно быть целым числом от 0 до 65534. Если задано значение 0, попытки подключения не истекает.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Credential
Если этот параметр указан, имя пользователя и пароль будут использоваться для подключения к указанному экземпляру сервера Analysis Server. Если учетные данные не указаны по умолчанию, учетная запись windows пользователя, на котором запущен инструмент, будет использоваться.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Database
Указывает базу данных, для которой будет выполняться запрос многомерных выражений или инструкция DMX. Параметр базы данных игнорируется при выполнении скрипта XMLA, так как имя базы данных встроено в скрипт XMLA.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-InputFile
Определяет файл, содержащий скрипт XMLA, многомерный запрос, инструкцию DMX или скрипт TMSL (в ФОРМАТЕ JSON). Необходимо указать значение для InputFile или параметра *Query *при использовании Invoke-AsCmd.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ProgressAction
Определяет, как PowerShell реагирует на обновления хода выполнения, созданные скриптом, командлетом или поставщиком, например индикаторами хода выполнения, созданными командлетом Write-Progress. Командлет Write-Progress создает индикаторы хода выполнения, показывающие состояние команды.
| Тип: | ActionPreference |
| Aliases: | proga |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Query
Задает фактический скрипт, запрос или инструкцию непосредственно в командной строке, а не в файле.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-QueryTimeout
Указывает количество секунд до истечения времени ожидания запросов. Если значение времени ожидания не указано, запросы не истекает. Время ожидания должно быть целым числом от 1 до 65535.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Server
При необходимости указывает экземпляр сервера для подключения, если он не находится в каталоге поставщика SQLAS.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ServicePrincipal
Указывает, что это подключение использует субъект-службу.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TenantId
Идентификатор клиента для субъекта-службы.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TraceFile
Определяет файл, который получает события трассировки служб Analysis Services при выполнении скрипта XMLA, запроса многомерных выражений или инструкции DMX. Если файл уже существует, он автоматически перезаписывается (за исключением файлов трассировки, созданных с помощью параметров -TraceLevel:Duration и -TraceLevel:DurationResult).
Имена файлов, содержащих пробелы, должны быть заключены в кавычки ("").
Если имя файла недопустимо, создается сообщение об ошибке.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TraceFileDelimiter
Указывает один символ в качестве разделителя файла трассировки при указании csv-файла в качестве формата файла трассировки, используюющего параметр -TraceFileFormat.
Значение по умолчанию — | (канал или вертикальная полоса).
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TraceFileFormat
Задает формат файла для параметра -TraceFile (если этот параметр указан).
Значением по умолчанию является csv-файл.
| Тип: | TraceFileFormatOption |
| Допустимые значения: | Csv, Text |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TraceLevel
Указывает, какие данные собираются и записываются в файле трассировки. Возможные значения: High, Medium, Low, DurationResult.
| Тип: | TraceLevelOption |
| Допустимые значения: | High, Medium, Low, Duration, DurationResult |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TraceTimeout
Указывает количество секунд, ожидающее ожидания подсистемы Служб Analysis Services перед окончанием трассировки (если указать параметр -TraceFile).
Трассировка считается завершенной, если сообщения трассировки не записываются в течение указанного периода времени.
Значение времени ожидания трассировки по умолчанию — 5 секунд.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Variables
Задает дополнительные переменные скриптов. Каждая переменная — это пара "имя- значение". Если значение содержит внедренные пробелы или символы элемента управления, оно должно быть заключено в двойные кавычки. Используйте массив PowerShell для указания нескольких переменных и их значений.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
PSObject
Выходные данные
string
Примечания
Поддерживается для всех экземпляров служб Analysis Services, включая PowerBI Premium
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по