다음을 통해 공유

Invoke-ASCmd

  • 참조
모듈:
SQLServer

데이터베이스 관리자가 Analysis Services 인스턴스에 대해 XMLA 스크립트, TMSL 스크립트, DAX(Data Analysis Expressions) 쿼리, MDX(다차원 식) 쿼리 또는 DMX(데이터 마이닝 확장) 문을 실행할 수 있도록 합니다.

구문

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

Description

데이터베이스 관리자가 Analysis Services 인스턴스에 대해 XMLA 스크립트, TMSL 스크립트, DAX(Data Analysis Expressions) 쿼리, MDX(다차원 식) 쿼리 또는 DMX(데이터 마이닝 확장) 문을 실행할 수 있도록 합니다.

입력 파일 내에서 이러한 쿼리 또는 스크립트의 cmdlet 실행입니다.

전달되는 스크립트는 XMLA 명령이며 다음 명령이 지원됩니다. Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement(MDX 쿼리 및 DMX 문을 실행하는 데 사용), 구독, 동기화, 잠금 해제, 업데이트, UpdateCells.

또한 이 스크립트는 호환성 모드가 1200 이상인 테이블 형식 데이터베이스에 대해 실행되도록 설계된 JSON 명령을 수락합니다.

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

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

Select 호출

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

서비스 주체의 애플리케이션 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CertificateThumbprint

서비스 주체의 인증서 지문입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭: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 인스턴스에 연결하는 데 사용됩니다. 자격 증명이 지정되지 않은 경우 도구를 실행하는 사용자의 기본 창 계정이 사용됩니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Database

MDX 쿼리 또는 DMX 문이 실행될 데이터베이스를 지정합니다. 데이터베이스 이름이 XMLA 스크립트에 포함되어 있으므로 cmdlet이 XMLA 스크립트를 실행할 때 데이터베이스 매개 변수는 무시됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputFile

XMLA 스크립트, MDX 쿼리, DMX 문 또는 TMSL 스크립트(JSON)가 포함된 파일을 식별합니다. Invoke-AsCmd를 사용하는 경우 InputFile 또는 *Query *매개 변수에 대한 값을 지정해야 합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProgressAction

powerShell이 스크립트, cmdlet 또는 공급자(예: Write-Progress cmdlet에서 생성된 진행률 표시줄)에 의해 생성된 진행률 업데이트에 응답하는 방법을 결정합니다. Write-Progress cmdlet은 명령의 상태를 표시하는 진행률 표시줄을 만듭니다.

형식:ActionPreference
별칭: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

서비스 주체의 테넌트 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-TraceFile

XMLA 스크립트, MDX 쿼리 또는 DMX 문을 실행하는 동안 Analysis Services 추적 이벤트를 수신하는 파일을 식별합니다. 파일이 이미 있는 경우 자동으로 덮어씁니다(-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

추적 파일에 수집 및 기록되는 데이터를 지정합니다. 가능한 값은 높음, 보통, 낮음, 기간, 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

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

PSObject

출력

string

참고

PowerBI Premium을 포함한 모든 Analysis Services 인스턴스에서 지원됨