Manage Azure Analysis Services with PowerShell

This article describes PowerShell cmdlets used to perform Azure Analysis Services server and database management tasks.

Server management tasks such as creating or deleting a server, suspending or resuming server operations, or changing the service level (tier) use Azure Resource Manager (AzureRM) cmdlets. Other tasks for managing databases such as adding or removing role members, processing, or partitioning use cmdlets included in the same SqlServer module as SQL Server Analysis Services.

Permissions

Most PowerShell tasks require you have Admin privileges on the Analysis Services server you are managing. Scheduled PowerShell tasks are unattended operations. The account running the scheduler must have Admin privileges on the Analysis Services server.

For server operations using AzureRm cmdlets, your account or the account running scheduler must also belong to the Owner role for the resource in Azure Role-Based Access Control (RBAC).

Server operations

Azure Analysis Services cmdlets are included in the AzureRM.AnalysisServices component module. To install AzureRM cmdlet modules, see Azure Resource Manager cmdlets in the PowerShell Gallery.

Cmdlet Description
Get-AzureRmAnalysisServicesServer Gets details of a server instance.
New-AzureRmAnalysisServicesServer Creates a server instance.
Remove-AzureRmAnalysisServicesServer Removes a server instance.
Suspend-AzureRmAnalysisServicesServe Suspends a server instance.
Resume-AzureRmAnalysisServicesServer Resumes a server instance.
Set-AzureRmAnalysisServicesServer Modifies a server instance.
Test-AzureRmAnalysisServicesServer Tests the existence of a server instance.

Database operations

Azure Analysis Services database operations use the same SqlServer module as SQL Server Analysis Services. However, not all cmdlets are supported for Azure Analysis Services.

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. The following cmdlets in the SqlServer module are supported for Azure Analysis Services.

Cmdlet Description
Add-RoleMember Add a member to a database role.
Backup-ASDatabase Backup an Analysis Services database.
Remove-RoleMember Remove a member from a database role.
Invoke-ASCmd Execute a TMSL script.
Invoke-ProcessASDatabase Process a database.
Invoke-ProcessPartition Process a partition.
Invoke-ProcessTable Process a table.
Merge-Partition Merge a partition.
Restore-ASDatabase Restore an Analysis Services database.