Invoke-ASCmd

Модуль:: SqlServer Module

Позволяет администраторам базы данных выполнять скрипт XMLA, скрипт TMSL, запросы выражений анализа данных (DAX), многомерные выражения (многомерные выражения) или инструкцию расширений интеллектуального анализа данных (DMX) для экземпляра служб Analysis Services.

Синтаксис

QuerySet (по умолчанию)

Invoke-ASCmd
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ParameterSetName

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

ParameterSetInputObject

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

ParameterSetTabularName

Invoke-ASCmd
    [-Server <String>]
    [-Credential <PSCredential>]
    [-ServicePrincipal]
    [-ApplicationId <String>]
    [-TenantId <String>]
    [-CertificateThumbprint <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ParameterSetTabularInputObject

Invoke-ASCmd
    [-Server <String>]
    [-Credential <PSCredential>]
    [-ServicePrincipal]
    [-ApplicationId <String>]
    [-TenantId <String>]
    [-CertificateThumbprint <String>]
    [-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
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-CertificateThumbprint

Отпечаток сертификата для субъекта-службы.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ConnectionString

Указывает строку подключения.

Обратите внимание, что другие свойства уровня подключения, такие как Сервер, База данных и т. д., игнорируются при указании этого свойства, поэтому эти свойства должны быть включены в строку подключения.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ConnectionTimeout

Указывает количество секунд до истечения времени ожидания подключения к экземпляру служб Analysis Services. Значение времени ожидания должно быть целым числом от 0 до 65534. Если задано значение 0, попытки подключения не истекает.

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Credential

Если этот параметр указан, имя пользователя и пароль будут использоваться для подключения к указанному экземпляру сервера Analysis Server. Если учетные данные не указаны по умолчанию, учетная запись windows пользователя, на котором запущен инструмент, будет использоваться.

Свойства параметра

Тип:	PSCredential
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Database

Указывает базу данных, для которой будет выполняться запрос многомерных выражений или инструкция DMX. Параметр базы данных игнорируется при выполнении скрипта XMLA, так как имя базы данных встроено в скрипт XMLA.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-InputFile

Определяет файл, содержащий скрипт XMLA, многомерный запрос, инструкцию DMX или скрипт TMSL (в ФОРМАТЕ JSON). Необходимо указать значение входного файла или параметра *Query *при использовании Invoke-AsCmd.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Query

Задает фактический скрипт, запрос или инструкцию непосредственно в командной строке, а не в файле.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-QueryTimeout

Указывает количество секунд до истечения времени ожидания запросов. Если значение времени ожидания не указано, запросы не истекает. Время ожидания должно быть целым числом от 1 до 65535.

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Server

При необходимости указывает экземпляр сервера для подключения, если он не находится в каталоге поставщика SQLAS.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ServicePrincipal

Указывает, что это подключение использует субъект-службу.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TenantId

Идентификатор клиента для субъекта-службы.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetTabularInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TraceFile

Определяет файл, который получает события трассировки служб Analysis Services при выполнении скрипта XMLA, запроса многомерных выражений или инструкции DMX. Если файл уже существует, он автоматически перезаписывается (за исключением файлов трассировки, созданных с помощью параметров -TraceLevel:Duration и -TraceLevel:DurationResult).

Имена файлов, содержащих пробелы, должны быть заключены в кавычки ("").

Если имя файла недопустимо, создается сообщение об ошибке.

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TraceFileDelimiter

Указывает один символ в качестве разделителя файла трассировки при указании csv-файла в качестве формата файла трассировки, используюющего параметр -TraceFileFormat.

Значение по умолчанию — | (канал или вертикальная полоса).

Свойства параметра

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TraceFileFormat

Задает формат файла для параметра -TraceFile (если этот параметр указан).

Значением по умолчанию является csv-файл.

Свойства параметра

Тип:	TraceFileFormatOption
Default value:	None
Допустимые значения:	Csv, Text
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TraceLevel

Указывает, какие данные собираются и записываются в файле трассировки. Возможные значения: High, Medium, Low, DurationResult.

Свойства параметра

Тип:	TraceLevelOption
Default value:	None
Допустимые значения:	High, Medium, Low, Duration, DurationResult
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-TraceTimeout

Указывает количество секунд, ожидающее ожидания подсистемы Служб Analysis Services перед окончанием трассировки (если указать параметр -TraceFile).

Трассировка считается завершенной, если сообщения трассировки не записываются в течение указанного периода времени.

Значение времени ожидания трассировки по умолчанию — 5 секунд.

Свойства параметра

Тип:	Int32
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Variables

Задает дополнительные переменные скриптов. Каждая переменная — это пара "имя- значение". Если значение содержит внедренные пробелы или символы элемента управления, оно должно быть заключено в двойные кавычки. Используйте массив PowerShell для указания нескольких переменных и их значений.

Свойства параметра

Тип:	String[]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

ParameterSetName

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

ParameterSetInputObject

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:	SwitchParameter
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

PSObject

Выходные данные

string

Обратная связь

Были ли сведения на этой странице полезными?

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

Invoke-ASCmd

Синтаксис

QuerySet (по умолчанию)

ParameterSetName

ParameterSetInputObject

ParameterSetTabularName

ParameterSetTabularInputObject

Описание

Примеры

Вызов обнаружения

Вызов обнаружения 2

Вызов выбора

Вызов 2

Вызов с помощью xmla-файла

Параметры

-ApplicationId

Свойства параметра

Наборы параметров

-CertificateThumbprint

Свойства параметра

Наборы параметров

-Confirm

Свойства параметра

Наборы параметров

-ConnectionString

Свойства параметра

Наборы параметров

-ConnectionTimeout

Свойства параметра

Наборы параметров

-Credential

Свойства параметра

Наборы параметров

-Database

Свойства параметра

Наборы параметров

-InputFile

Свойства параметра

Наборы параметров

-Query

Свойства параметра

Наборы параметров

-QueryTimeout

Свойства параметра

Наборы параметров

-Server

Свойства параметра

Наборы параметров

-ServicePrincipal

Свойства параметра

Наборы параметров

-TenantId

Свойства параметра

Наборы параметров

-TraceFile

Свойства параметра

Наборы параметров

-TraceFileDelimiter

Свойства параметра

Наборы параметров

-TraceFileFormat

Свойства параметра

Наборы параметров

-TraceLevel

Свойства параметра

Наборы параметров

-TraceTimeout

Свойства параметра

Наборы параметров

-Variables

Свойства параметра

Наборы параметров

-WhatIf

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

PSObject

Выходные данные