Invoke-ASCmd

모듈:

SQLServer

데이터베이스 관리자가 Analysis Services의 instance 대해 XMLA 스크립트, TMSL 스크립트, DAX(데이터 분석 식) 쿼리, MDX(다차원 식) 쿼리 또는 DMX(데이터 마이닝 확장) 문을 실행할 수 있습니다.

Syntax

Invoke-ASCmd
      [-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>]
      [-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>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

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

Description

데이터베이스 관리자가 Analysis Services의 instance 대해 XMLA 스크립트, TMSL 스크립트, DAX(데이터 분석 식) 쿼리, 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>"

호출 선택

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입니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

서비스 주체에 대한 인증서 지문입니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionString

연결 문자열을 지정합니다.

서버, 데이터베이스 등과 같은 다른 연결 수준 속성은 주의하세요. 이 속성을 지정하면 무시되므로 이러한 속성은 연결 문자열에 포함되어야 합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionTimeout

Analysis Services에 대한 연결 시간이 초과되기 전의 시간(초)instance 지정합니다. 시간 제한 값은 0에서 65534 사이의 정수여야 합니다. 0을 지정하면 연결 시도 시간이 제한되지 않습니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

이 매개 변수를 지정하면 전달된 사용자 이름 및 암호를 사용하여 지정된 Analysis Server 인스턴스에 연결합니다. 자격 증명을 지정하지 않으면 도구를 실행 중인 사용자의 기본 Windows 계정이 사용됩니다.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Database

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputFile

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Query

파일 대신 명령줄에서 실제 스크립트, 쿼리 또는 문을 직접 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-QueryTimeout

쿼리 시간이 초과되기 전의 시간(초)을 지정합니다. 시간 제한 값을 지정하지 않으면 쿼리 시간이 초과되지 않습니다. 시간 제한은 1에서 65535 사이의 정수여야 합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Server

필요에 따라 현재 SQLAS 공급자 디렉터리에 없는 경우 연결할 서버 instance 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

이 연결이 서비스 주체를 사용 중임을 지정합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TenantId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFile

XMLA 스크립트, MDX 쿼리 또는 DMX 문을 실행하는 동안 Analysis Services 추적 이벤트를 받는 파일을 식별합니다. 파일이 이미 있는 경우 자동으로 덮어씁니다(-TraceLevel:Duration 및 -TraceLevel:DurationResult 매개 변수 설정을 사용하여 만든 추적 파일 제외).

공백이 포함된 파일 이름은 따옴표("")로 묶어야 합니다.

파일 이름이 잘못된 경우 오류 메시지가 생성됩니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFileDelimiter

-TraceFileFormat 매개 변수를 사용하는 추적 파일의 형식으로 csv를 지정할 때 단일 문자를 추적 파일 구분 기호로 지정합니다.

기본값은 |(파이프 또는 세로 막대)입니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceFileFormat

-TraceFile 매개 변수의 파일 형식을 지정합니다(이 매개 변수가 지정된 경우).

기본값은 "Csv"입니다.

Type:	TraceFileFormatOption
Accepted values:	Csv, Text
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceLevel

추적 파일에 수집되고 기록되는 데이터 종류를 지정합니다. 사용할 수 있는 값은 High, Medium, Low, Duration 또는 DurationResult입니다.

Type:	TraceLevelOption
Accepted values:	High, Medium, Low, Duration, DurationResult
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TraceTimeout

추적을 종료하기 전에 Analysis Services 엔진이 대기하는 시간(-TraceFile 매개 변수를 지정하는 경우)을 지정합니다.

지정한 기간 동안 추적 메시지가 기록되지 않으면 추적은 완료된 것으로 간주됩니다.

기본 추적 제한 시간 값은 5초입니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Variables

추가 스크립팅 변수를 지정합니다. 각 변수는 이름 - 값 쌍입니다. 값에 공백이나 제어 문자가 있으면 해당 문자를 큰따옴표(")로 묶어야 합니다. 변수 및 해당 값을 여러 개 지정하려면 PowerShell 배열을 사용합니다.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

PSObject

출력

string

참고

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