Командлет Invoke-ASCmd
Позволяет администратору базы данных выполнять скрипты 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>]
Описание
Командлет ASCmd может выполнять запросы или скрипты, содержащиеся во входных файлах. Поддерживаются следующие команды: Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, SetPasswordEncryptionKey, Statement (используется для выполнения запросов многомерных выражений и инструкций расширений интеллектуального анализа данных), Subscribe, Synchronize, Unlock, Update, UpdateCells.
Этот командлет поддерживает параметр –Credential, который можно использовать, если экземпляр служб Analysis Services настроен для доступа по протоколу HTTP. Параметр –Credential принимает объект PSCredential, который содержит идентификатор пользователя Windows. Службы IIS будут олицетворять этого пользователя при подключении к службам Analysis Services. Чтобы запустить скрипт, необходимо обладать разрешениями системного администратора на этом экземпляре служб Analysis Services.
Параметры
-Query <строка>
Указывает, что фактический скрипт, запрос или инструкция задается непосредственно в командной строке, а не в файле. Также запрос можно указать в качестве входа конвейера. При использовании Invoke-AsCmd необходимо указать либо значение –InputFile, либо значение –Query.
Обязательное поле? |
true |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
True (ByValue) |
Принимать символы-шаблоны? |
false |
-InputFile <строка>
Идентифицирует файл, содержащий скрипт XMLA, запрос многомерных выражений или инструкцию DMX. При использовании Invoke-AsCmd необходимо указать либо значение –InputFile, либо значение –Query.
Обязательное поле? |
true |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Server <строка>
Указывает экземпляр служб Analysis Services, к которому подключится командлет и где он будет выполняться. Если имя сервера не указано, произойдет подключение к серверу localhost. Для экземпляров по умолчанию достаточно указать имя сервера. Для именованных экземпляров используйте формат имя_сервера\имя_экземпляра. Для HTTP-соединений используйте формат http[s]://server[:port]/virtualdirectory/msmdpump.dll.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
localhost |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Database <строка>
Определяет базу данных, в которой выполняются запросы MDX или инструкции DMX. Параметр базы данных не учитывается, если командлет выполняет скрипт XML для аналитики, так как скрипт XML для аналитики содержит внедренное имя базы данных.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Credential <PSCredential>
Указывает объект PSCredential, который содержит имя пользователя и пароль Windows. Укажите этот параметр, только если экземпляр служб Analysis Services настроен для доступа HTTP с использованием обычной проверки подлинности. Для соединений в собственном режиме, в которых используются интегрированные функции безопасности, этот параметр не учитываются.
Если этот параметр указан, учетные данные, которые он содержит, добавляются в строку подключения. Службы IIS будут олицетворять этого пользователя при соединении со службами Analysis Services. Если учетные данные не будут указаны, будут использованы учетные данные по умолчанию для пользователя, который запускает это средство.
Для использования этого параметра необходимо сначала создать объект PSCredential с помощью командлета Get-Credential, чтобы указать имя пользователя и пароль (например, $Cred=Get-Credential “adventure-works\admin”; этот объект можно затем передать по конвейеру в параметр –Credential (-Credential:$Cred).
Дополнительные сведения о проверке подлинности и использовании учетных данных см. в разделе Analysis Services PowerShell. Дополнительные сведения о доступе по протоколу HTTP см. в разделе Настройка HTTP-доступа к службам Analysis Services в службах Internet Information Services (IIS) 7.0.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
True (ByValue) |
Принимать символы-шаблоны? |
false |
-ConnectionTimeout <int>
Задает количество секунд до истечения времени ожидания соединения с экземпляром служб Analysis Services. Значение времени ожидания должно быть целым числом от 0 до 65534. Если указано значение 0, попытки соединения не прекращаются.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
30 |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-QueryTimeout <int>
Задает время ожидания запросов (в секундах). Если значение времени ожидания не указано, срок выполнения запросов не ограничен. Время ожидания должно быть целым числом от 1 до 65535.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
30 |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-Variable <строка[]>
Задаются дополнительные переменные скрипта. Каждая переменная является парой «имя-значение». Если в значении содержатся пробелы или управляющие символы, оно должно заключаться в двойные кавычки. Для указания нескольких переменных и их значений используйте массив PowerShell.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-TraceFile <строка>
Определяет файл, в который поступают события трассировки служб Analysis Services при выполнении скрипта XML для аналитики, запроса многомерных выражений или инструкции расширений интеллектуального анализа данных. Если файл уже существует, он будет автоматически перезаписан (кроме файлов трассировки, созданных с параметрами -TraceLevel:Duration и –TraceLevel:DurationResult). Имена файлов, содержащие пробелы, должны быть заключены в кавычки (" "). Если указано недопустимое имя файла, выдается сообщение об ошибке.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-TraceFileFormat <строка>
Устанавливает формат файла для параметра –TraceFile (если этот параметр указан). Доступны следующие значения: text и csv. Значением по умолчанию является «csv».
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
csv |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-TraceFileDelimiter <строка>
Указывает, какой символ будет использоваться в качестве разделителя в файле трассировки, если выбран формат файла трассировки CSV. Разделителем по умолчанию является символ | (вертикальная черта).
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
|
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-TraceTimeout <int>
Задает количество секунд, в течение которых ядро служб Analysis Services ожидает, прежде чем завершить трассировку (если указан параметр –TraceFile). Предполагается, что трассировка заканчивается, если в течение заданного периода времени не записываются никакие сообщения трассировки. По умолчанию период равен 5 секундам.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
5 |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
-TraceLevel <TraceLevelOption>
Задает тип данных, которые собираются и записываются в файл трассировки. Возможны следующие значения: High, Medium, Low, Duration, DurationResult.
Обязательное поле? |
false |
Положение? |
именованный |
Значение по умолчанию |
High |
Принимать входные данные конвейера? |
false |
Принимать символы-шаблоны? |
false |
<Общие параметры>
Этот командлет поддерживает общие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе About_CommonParameters.
Входы и выходы
Входной тип — это тип объектов, которые можно направить в командлет. Возвращаемый тип — это тип объектов, возвращаемых командлетом.
Входы |
PSObject |
Выходы |
Строковые значения |
Пример 1
Invoke-ASCmd –InputFile:”C:\MyFolder\DiscoverConnections.xmla”
Эта команда выполняет скрипт XML для аналитики, возвращающий список активных соединений с сервером. Файл DiscoverConnections.xmla содержит следующий скрипт XML для аналитики:
<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>"
Запрос Discover в XML для аналитики возвращает доступные источники данных для сервера анализа данных, а также необходимые для подключения к ним сведения. Результаты возвращаются в формате XML. Чтобы упростить чтение, выходные данные можно перенаправить в XML-файл (например, добавив к команде строку | Out-file C:\Results\XMLAQueryOutput.xml) и просмотреть результаты в браузере или другом приложении, поддерживающем структурированный XML-код.