az quantum workspace user

Note

This reference is part of the quantum extension for the Azure CLI (version 2.73.0 or higher). The extension will automatically install the first time you run an az quantum workspace user command. Learn more about extensions.

Command group 'quantum' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Manage users of an Azure Quantum workspace.

Commands

Name Description Type Status
az quantum workspace user add

Grant a user access to an Azure Quantum workspace.

Extension Preview
az quantum workspace user list

List the users with access to an Azure Quantum workspace.

Extension Preview
az quantum workspace user remove

Remove a user's access to an Azure Quantum workspace.

Extension Preview

az quantum workspace user add

Preview

Command group 'quantum' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Grant a user access to an Azure Quantum workspace.

Assigns the 'Quantum Workspace Data Contributor' role at the scope of the given (or current) Azure Quantum workspace. If the user already has the 'Quantum Workspace Data Contributor' or 'Quantum Workspace Owner' role at the workspace, including access inherited from the resource group or subscription, the command returns an existing assignment without creating a new one.

az quantum workspace user add --email
                              [--acquire-policy-token]
                              [--change-reference]
                              [--resource-group]
                              [--workspace-name]

Examples

Grant a user access to a workspace using their email address.

az quantum workspace user add -g MyResourceGroup -w MyWorkspace \
    --email user@contoso.com

Required Parameters

--email

The email address of the user to grant or remove access.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Name of the Quantum Workspace. You can configure the default workspace using az quantum workspace set.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az quantum workspace user list

Preview

Command group 'quantum' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

List the users with access to an Azure Quantum workspace.

Lists user principals (excluding groups and service principals) assigned the 'Quantum Workspace Owner' or 'Quantum Workspace Data Contributor' role for the given (or current) workspace. Each user's Name and Email are resolved from Microsoft Graph. By default this includes access inherited from the parent resource group and subscription; pass '--include-inherited false' to list only assignments scoped directly to the workspace.

az quantum workspace user list [--include-inherited {false, true}]
                               [--resource-group]
                               [--workspace-name]

Examples

List all users with access to a workspace.

az quantum workspace user list -g MyResourceGroup -w MyWorkspace

List only users assigned directly on the workspace (exclude inherited access).

az quantum workspace user list -g MyResourceGroup -w MyWorkspace --include-inherited false

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--include-inherited

Include role assignments inherited from the parent resource group and subscription. Enabled by default; use "--include-inherited false" to list only assignments scoped directly to the workspace.

Property Value
Default value: True
Accepted values: false, true
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Name of the Quantum Workspace. You can configure the default workspace using az quantum workspace set.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az quantum workspace user remove

Preview

Command group 'quantum' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Remove a user's access to an Azure Quantum workspace.

Removes the 'Quantum Workspace Data Contributor' and 'Quantum Workspace Owner' role assignments scoped directly to the given (or current) Azure Quantum workspace. Role assignments inherited from the resource group or subscription must be removed at that scope.

az quantum workspace user remove --email
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--resource-group]
                                 [--workspace-name]
                                 [--yes]

Examples

Remove a user's access to a workspace using their email address.

az quantum workspace user remove -g MyResourceGroup -w MyWorkspace \
    --email user@contoso.com

Required Parameters

--email

The email address of the user to grant or remove access.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--workspace-name -w

Name of the Quantum Workspace. You can configure the default workspace using az quantum workspace set.

--yes -y

Do not prompt for confirmation.

Property Value
Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False