Dax.Optimizer.CLI 1.5.2

Dax.Optimizer.CLI

A .NET tool that provides command-line access to DAX Optimizer.

Installation

dotnet tool install Dax.Optimizer.CLI --global

Authentication

Choose the authentication mode based on your account type and whether you need interactive or automated access.

Individual Account

Use this mode when both the license and the model belong to your personal account. Run login once to authenticate via browser — the session is saved locally for subsequent commands.

daxoptimizer login --region <region>
daxoptimizer analyze file.vpax --workspace-id <id> --model-id <id>

Use daxoptimizer logout to clear the saved session.

Group Account

Use this mode when the model and license belong to a group account. Run login with --group-account to authenticate via browser and save the group account context — subsequent commands use that context automatically. Your user must be a member of the group account.

daxoptimizer login --region <region> --group-account <group-account-name>
daxoptimizer analyze file.vpax --workspace-id <id> --model-id <id>

Personal Access Token

Provide --username (PAT client ID) and --password (PAT secret) directly on the analyze command for non-interactive authentication. This mode is intended for automation (e.g. CI/CD pipelines) and requires a group account with an active Enterprise license. The --region option is required when using PAT authentication.

daxoptimizer analyze file.vpax --username "my-group-account" --password "my-secret" --region <region> --workspace-id <id> --model-id <id>

For more information on automation, see the how-to guide.

Command reference

Run daxoptimizer -? or daxoptimizer <command> -? for full option details.

Examples

The following examples use the analyze command to upload a local VPAX file for analysis in DAX Optimizer. By adding the --output option, the analysis results are also saved locally as a .zip file containing a JSON file with the full model analysis, including identified issues and recommendations.

Tip: In the DAX Optimizer web application, right-click on a model to auto-generate the CLI command with the correct parameters already filled in.

Interactive login (individual account)

daxoptimizer login --region "westeurope"
daxoptimizer analyze "C:\models\sales.vpax" --workspace-id <id> --model-id <id> --output "C:\path\file.zip"

Interactive login (group account)

daxoptimizer login --region "westeurope" --group-account "my-group-account"
daxoptimizer analyze "C:\models\sales.vpax" --workspace-id <id> --model-id <id> --output "C:\path\file.zip"

Automation CI/CD (PAT)

daxoptimizer analyze "C:\models\sales.vpax" --username "my-group-account" --password "my-secret" --region "westeurope" --workspace-id <id> --model-id <id> --output "C:\path\file.zip"