Invoke-ASCmd cmdlet
데이터베이스 관리자가 XMLA 스크립트, MDX(Multidimensional Expressions) 또는 DMX(Data Mining Extensions) 문을 실행할 수 있게 해 줍니다.
구문
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>]
설명
Invoke-ASCmd cmdlet은 입력 파일에 포함된 쿼리 또는 스크립트를 실행할 수 있습니다. 지원되는 명령은 Alter, Backup, Batch, BeginTransaction, Cancel, ClearCache, CommitTransaction, Create, Delete, DesignAggregations, Drop, Insert, Lock, MergePartitions, NotifyTableChange, Process, Restore, RollbackTransaction, Statement(MDX 쿼리 및 DMX 문을 실행하는 데 사용됨), Subscribe, Synchronize, Unlock, Update, UpdateCells입니다.
이 cmdlet은 –Credential 매개 변수를 지원하며, 이 매개 변수는 HTTP 액세스를 위해 Analysis Services 인스턴스를 구성한 경우 사용할 수 있습니다. –Credential 매개 변수는 Windows 사용자 ID를 제공하는 PSCredential 개체를 사용합니다. IIS는 Analysis Services에 연결할 때 이 사용자를 가장합니다. 스크립트를 실행하려면 ID에 Analysis Services 인스턴스에 대한 시스템 관리자 권한이 있어야 합니다.
매개 변수
-Query <string>
파일 대신 명령줄에서 실제 스크립트, 쿼리 또는 문을 직접 지정합니다. 쿼리를 파이프라인 입력으로 지정할 수도 있습니다. Invoke-AsCmd를 사용하는 경우 –InputFile 또는 –Query 매개 변수의 값을 지정해야 합니다.
필수 여부 |
true |
위치 |
명명됨 |
기본값 |
|
파이프라인 입력 허용 |
True(ByValue) |
와일드카드 문자 허용 |
false |
-InputFile <string>
XMLA 스크립트, MDX 쿼리 또는 DMX 문이 포함된 파일을 식별합니다. Invoke-AsCmd를 사용하는 경우 –InputFile 또는 –Query 매개 변수의 값을 지정해야 합니다.
필수 여부 |
true |
위치 |
명명됨 |
기본값 |
|
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-Server <string>
cmdlet이 연결하고 실행할 Analysis Services 인스턴스를 지정합니다. 서버 이름을 제공하지 않으면 localhost에 연결됩니다. 기본 인스턴스의 경우에는 서버 이름만 지정합니다. 명명된 인스턴스의 경우에는 servername\instancename 형식을 사용합니다. HTTP 연결의 경우 http[s]://server[:port]/virtualdirectory/msmdpump.dll 형식을 사용합니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
localhost |
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-Database <string>
MDX 쿼리 또는 DMX 문이 실행될 데이터베이스를 지정합니다. 데이터베이스 이름이 XMLA 스크립트에 포함되어 있으므로 cmdlet이 XMLA 스크립트를 실행할 때 데이터베이스 매개 변수는 무시됩니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
|
파이프라인 입력 허용 |
false |
와일드카드 문자 적용 여부 |
false |
-Credential <PSCredential>
Windows 사용자 이름 및 암호를 제공하는 PSCredential 개체를 지정합니다. Analysis Services 인스턴스가 기본 인증을 사용하여 HTTP 액세스를 사용하도록 구성된 경우에만 이 매개 변수를 지정합니다. 통합 보안을 사용하는 네이티브 연결의 경우에는 이 매개 변수가 무시됩니다.
이 매개 변수가 있으면 해당 매개 변수가 제공하는 자격 증명이 연결 문자열에 추가됩니다. IIS는 Analysis Services에 연결할 때 이 사용자 ID를 가장합니다. 자격 증명을 지정하지 않으면 도구를 실행 중인 사용자의 기본 Windows 계정이 사용됩니다.
이 매개 변수를 사용하려면 먼저 Get-Credential을 사용하여 PSCredential 개체를 만들어 사용자 이름 및 암호를 지정합니다(예: $Cred=Get-Credential “adventure-works\admin”). 그런 다음 이 개체를 –Credential 매개 변수에 파이프할 수 있습니다(-Credential:$Cred).
인증 및 자격 증명 사용에 대한 자세한 내용은 Analysis Services PowerShell을 참조하십시오. HTTP 액세스에 대한 자세한 내용은 IIS(인터넷 정보 서비스) 7.0에서 Analysis Services에 대한 HTTP 액세스 구성을 참조하십시오.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 허용 |
True(ByValue) |
와일드카드 문자 허용 |
false |
-ConnectionTimeout <int>
Analysis Services 인스턴스에 대한 연결 제한 시간을 나타내는 시간(초)을 지정합니다. 제한 시간 값은 0에서 65534 사이의 정수여야 합니다. 0을 지정하면 연결 시간이 제한되지 않습니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
30 |
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-QueryTimeout <int>
쿼리 제한 시간(초)을 지정합니다. 제한 시간 값을 지정하지 않으면 쿼리 시간이 제한되지 않습니다. 제한 시간은 1에서 65535 사이의 정수여야 합니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
30 |
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-Variable <string[]>
추가 스크립팅 변수를 지정합니다. 각 변수는 이름 - 값 쌍입니다. 값에 공백이나 제어 문자가 있으면 해당 문자를 큰따옴표(")로 묶어야 합니다. 변수 및 해당 값을 여러 개 지정하려면 PowerShell 배열을 사용합니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
|
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-TraceFile <string>
XMLA 스크립트, MDX 쿼리 또는 DMX 문을 실행하는 동안 Analysis Services 추적 이벤트를 받는 파일을 식별합니다. 파일이 이미 있으면 해당 파일을 자동으로 덮어씁니다. 단, -TraceLevel:Duration 및 –TraceLevel:DurationResult 매개 변수 설정을 사용하여 만든 추적 파일은 예외입니다. 공백이 포함된 파일 이름은 따옴표("")로 묶어야 합니다. 파일 이름이 잘못된 경우 오류 메시지가 생성됩니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
|
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-TraceFileFormat <string>
–TraceFile 매개 변수(지정한 경우)의 파일 형식을 지정합니다. 사용할 수 있는 옵션은 text 또는 csv입니다. 기본값은 "csv"입니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
csv |
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-TraceFileDelimiter <string>
추적 파일 형식으로 csv를 지정할 때 추적 파일 구분 기호로 사용할 문자를 지정합니다. 기본값은 |(파이프 또는 세로 막대)입니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
|
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-TraceTimeout <int>
–TraceFile 매개 변수를 지정한 경우 추적을 끝낼 때까지 Analysis Services 엔진이 대기하는 시간(초)을 지정합니다. 지정한 기간 동안 추적 메시지가 기록되지 않으면 추적은 완료된 것으로 간주됩니다. 기본 추적 제한 시간 값은 5초입니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
5 |
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
-TraceLevel <TraceLevelOption>
추적 파일에 수집되고 기록되는 데이터 종류를 지정합니다. 사용할 수 있는 값은 High, Medium, Low, Duration 또는 DurationResult입니다.
필수 여부 |
false |
위치 |
명명됨 |
기본값 |
High |
파이프라인 입력 허용 |
false |
와일드카드 문자 허용 |
false |
<CommonParameters>
이 cmdlet은 공통 매개 변수인 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 About_CommonParameters를 참조하십시오.
입력 및 출력
입력 유형은 cmdlet에 파이프할 수 있는 개체 유형입니다. 반환 유형은 cmdlet에서 반환하는 개체 유형입니다.
입력 |
PSObject |
출력 |
문자열 |
예 1
Invoke-ASCmd –InputFile:”C:\MyFolder\DiscoverConnections.xmla”
이 명령은 서버의 활성 연결 목록을 반환하는 XMLA 스크립트를 실행합니다. DiscoverConnections.xmla 파일에는 다음 XMLA 스크립트가 포함됩니다.
<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 XMLA 쿼리는 분석 서버가 사용할 수 있는 데이터 원본 및 해당 원본에 연결하는 데 필요한 정보를 반환합니다. 결과는 XML로 표시됩니다. 가독성을 높이기 위해 출력을 XML 파일로 파이프한 다음(예: 명령에 | Out-file C:\Results\XMLAQueryOutput.xml 추가) 그 결과를 브라우저 또는 구조화된 XML을 지원하는 다른 응용 프로그램에서 볼 수 있습니다.