az datashare invitation

Is this page helpful?

Any additional feedback?

Feedback will be sent to Microsoft: By pressing the submit button, your feedback will be used to improve Microsoft products and services. Privacy policy.

Note

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

Manage invitation with datashare.

Commands

az datashare invitation create	Create an invitation.
az datashare invitation delete	Delete an invitation in a share.
az datashare invitation list	List invitations in a share.
az datashare invitation show	Get an invitation in a share.

az datashare invitation create

Create an invitation.

az datashare invitation create --account-name
                               --invitation-name
                               --resource-group
                               --share-name
                               [--expiration-date]
                               [--target-active-directory-id]
                               [--target-email]
                               [--target-object-id]

Examples

Invitations_Create

az datashare invitation create --account-name "Account1" --expiration-date "2020-08-26T22:33:24.5785265Z" --target-email "receiver@microsoft.com" --name "Invitation1" --resource-group "SampleResourceGroup" --share-name "Share1"

Required Parameters

--account-name

The name of the share account.

--invitation-name --name -n

The name of the invitation.

--resource-group -g

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

--share-name

The name of the share to send the invitation for.

Optional Parameters

--expiration-date

The expiration date for the invitation and share subscription.

--target-active-directory-id

The target Azure AD Id. Can't be combined with email.

--target-email

The email the invitation is directed to.

--target-object-id

The target user or application Id that invitation is being sent to. Must be specified along TargetActiveDirectoryId. This enables sending invitations to specific users or applications in an AD tenant.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--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.

az datashare invitation delete

Delete an invitation in a share.

az datashare invitation delete --account-name
                               --invitation-name
                               --resource-group
                               --share-name
                               [--yes]

Examples

Invitations_Delete

az datashare invitation delete --account-name "Account1" --name "Invitation1" --resource-group "SampleResourceGroup" --share-name "Share1"

Required Parameters

--account-name

The name of the share account.

--invitation-name --name -n

The name of the invitation.

--resource-group -g

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

--share-name

The name of the share.

Optional Parameters

--yes -y

Do not prompt for confirmation.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--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.

az datashare invitation list

List invitations in a share.

az datashare invitation list --account-name
                             --resource-group
                             --share-name
                             [--filter]
                             [--orderby]
                             [--skip-token]

Examples

Invitations_ListByShare

az datashare invitation list --account-name "Account1" --resource-group "SampleResourceGroup" --share-name "Share1"

Required Parameters

--account-name

The name of the share account.

--resource-group -g

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

--share-name

The name of the share.

Optional Parameters

--filter

Filters the results using OData syntax.

--orderby

Sorts the results using OData syntax.

--skip-token

The continuation token.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--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.

az datashare invitation show

Get an invitation in a share.

az datashare invitation show --account-name
                             --invitation-name
                             --resource-group
                             --share-name

Examples

Invitations_Get

az datashare invitation show --account-name "Account1" --name "Invitation1" --resource-group "SampleResourceGroup" --share-name "Share1"

Required Parameters

--account-name

The name of the share account.

--invitation-name --name -n

The name of the invitation.

--resource-group -g

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

--share-name

The name of the share.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--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.