PowerShell で Azure Analysis Services を管理するManage Azure Analysis Services with PowerShell

この記事では、Azure Analysis Services サーバーおよびデータベース管理タスクを実行するときに使用する PowerShell コマンドレットについて説明します。This article describes PowerShell cmdlets used to perform Azure Analysis Services server and database management tasks.

サーバーの作成または削除、操作の中断または再開、サービスレベル(層)の変更などのサーバー リソース管理タスクでは、Azure Analysis Services コマンドレットを使用します。Server resource management tasks like creating or deleting a server, suspending or resuming server operations, or changing the service level (tier) use Azure Analysis Services cmdlets. ロール メンバーの追加や削除、処理、パーティション分割など、その他のデータベース管理タスクでは、SQL Server Analysis Services と同じ SqlServer モジュールに含まれるコマンドレットが使われます。Other tasks for managing databases like adding or removing role members, processing, or partitioning use cmdlets included in the same SqlServer module as SQL Server Analysis Services.

注意

この記事は、新しい Azure PowerShell Az モジュールを使用するために更新されました。This article has been updated to use the new Azure PowerShell Az module. AzureRM モジュールはまだ使用でき、少なくとも 2020 年 12 月までは引き続きバグ修正が行われます。You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Az モジュールと AzureRM の互換性の詳細については、「Introducing the new Azure PowerShell Az module (新しい Azure PowerShell Az モジュールの概要)」を参照してください。To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Az モジュールのインストール手順については、Azure PowerShell のインストールを参照してください。For Az module installation instructions, see Install Azure PowerShell.

アクセス許可Permissions

ほとんどの PowerShell タスクでは、管理している Analysis Services サーバーに対する管理者権限が必要となります。Most PowerShell tasks require you have Admin privileges on the Analysis Services server you are managing. スケジュールされた PowerShell タスクは無人操作です。Scheduled PowerShell tasks are unattended operations. スケジューラを実行するアカウントまたはサービス プリンシパルには、Analysis Services サーバーに対する管理者特権が必要です。The account or service principal running the scheduler must have Admin privileges on the Analysis Services server.

Azure PowerShell コマンドレットを使用したサーバー操作の場合、自分のアカウントまたはスケジューラを実行するアカウントが、Azure のロールベースのアクセス制御 (RBAC) でリソースの所有者ロールに属していることも必要になります。For server operations using Azure PowerShell cmdlets, your account or the account running scheduler must also belong to the Owner role for the resource in Azure role-based access control (Azure RBAC).

リソースとサーバーの操作Resource and server operations

モジュールのインストール - Az.AnalysisServices Install module - Az.AnalysisServices
ドキュメント - Az.AnalysisServices リファレンスDocumentation - Az.AnalysisServices reference

データベース操作Database operations

Azure Analysis Services のデータベース操作では、SQL Server Analysis Services と同じ SqlServer モジュールが使われます。Azure Analysis Services database operations use the same SqlServer module as SQL Server Analysis Services. ただし、すべてのコマンドレットが、Azure Analysis Services でサポートされているわけではありません。However, not all cmdlets are supported for Azure Analysis Services.

SqlServer モジュールには、タスク固有のデータベース管理コマンドレットと、Tabular Model Scripting Language (TMSL) クエリまたはスクリプトを受け入れる汎用 Invoke-ASCmd コマンドレットが用意されています。The SqlServer module provides task-specific database management cmdlets as well as the general-purpose Invoke-ASCmd cmdlet that accepts a Tabular Model Scripting Language (TMSL) query or script. 以下の SqlServer モジュールのコマンドレットは、Azure Analysis Services でサポートされます。The following cmdlets in the SqlServer module are supported for Azure Analysis Services.

モジュールのインストール - SqlServer Install module - SqlServer
ドキュメント - SqlServer リファレンスDocumentation - SqlServer reference

サポートされているコマンドレットSupported cmdlets

コマンドレットCmdlet 説明Description
Add-RoleMemberAdd-RoleMember データベース ロールにメンバーを追加します。Add a member to a database role.
Backup-ASDatabaseBackup-ASDatabase Analysis Services データベースをバックアップします。Backup an Analysis Services database.
Remove-RoleMemberRemove-RoleMember データベース ロールからメンバーを削除します。Remove a member from a database role.
Invoke-ASCmdInvoke-ASCmd TMSL スクリプトを実行します。Execute a TMSL script.
Invoke-ProcessASDatabaseInvoke-ProcessASDatabase データベースを処理します。Process a database.
Invoke-ProcessPartitionInvoke-ProcessPartition パーティションを処理します。Process a partition.
Invoke-ProcessTableInvoke-ProcessTable テーブルを処理します。Process a table.
Merge-PartitionMerge-Partition パーティションをマージします。Merge a partition.
Restore-ASDatabaseRestore-ASDatabase Analysis Services データベースを復元します。Restore an Analysis Services database.