다음을 통해 공유

Invoke-ASCmd

모듈:
SqlServer Module

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

구문

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

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

매개 변수 속성

형식: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

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

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ParameterSetName
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ParameterSetInputObject
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputFile

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

매개 변수 속성

형식: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

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

매개 변수 속성

형식: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

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

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

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSObject

출력

string