Invoke-ASCmd

Ссылка

Модуль:: SQLServer

Позволяет администраторам базы данных выполнять скрипт 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 и поддерживаются следующие команды: 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

Поделиться через