[Doc]: All DataShare documents

[zencifil]

Description

Data Share is a very confusing concept and none of the documents is clear about how to implement that. For example on New-AzDataShareDataSetMapping page, it says

-StorageAccountResourceId
Azure Storage Account ResourceId

But never says if this is provider storage account or consumer storage account. Same thing for -AccountName and -ResourceGroup parameters.

It is already a confusing topic and the documentation isn't really helping.

Thank you for your feedback. This has been routed to the support team for assistance.

[navba-MSFT]

@zencifil Thanks for reaching out to us and reporting this issue. We are looking into this issue and we will provide an update.

[navba-MSFT]

@zencifil The StorageAccountResourceId parameter in the "New-AzDataShareDataSetMapping" PowerShell cmdlet is used to specify the resource ID of the Azure storage account that is the source of the data being shared. This parameter is required when creating a new data set mapping for an Azure Data Share and is used to identify the storage account from which the data will be shared. The resource ID of the storage account can be obtained from the Azure portal or through Azure PowerShell.

The AccountName parameter in the "New-AzDataShareDataSetMapping" PowerShell cmdlet is used to specify the name of the Azure storage account that is the source of the data being shared. This parameter is required when creating a new data set mapping for an Azure Data Share and is used to identify the storage account from which the data will be shared. The account name of the storage account must be unique within Azure and can be used to access the storage account and the data stored within it.

The ResourceGroup parameter in the "New-AzDataShareDataSetMapping" PowerShell cmdlet is used to specify the name of the Azure resource group that contains the Azure storage account being shared. This parameter is required when creating a new data set mapping for an Azure Data Share and is used to identify the resource group that holds the storage account from which the data will be shared. The resource group can be used to manage the resources within it, such as the storage account and the data set mapping.

I will also create a PR to fix this documentation.

[zencifil]

@navba-MSFT Thanks for the clarification. I'm having trouble running this command though. Here is my code and I checked every variable to see if they have value.

New-AzDataShareDataSetMapping -ResourceGroupName "$sourceResourceGroupName" ` 
         -AccountName "$sourceDataShareAccountName" `
         -ShareSubscriptionName "$shareSubscriptionName" `
         -Name "$sourceDatasetName" `
         -StorageAccountResourceId "$sourceStorageResourceId" `
         -DataSetId "$sourceDatasetId" `
         -Container "$sourceContainerName"

I found this document and it's the same command with the same parameters (even the same order). But I keep getting the error below.

New-AzDataShareDataSetMapping: /agent/_work/_temp/a684a554-3272-481d-94a2-0bdc610f4304.ps1:82
Line |
  82 |    New-AzDataShareDataSetMapping -ResourceGroupName "$sourceResourceGr …
     |    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | Parameter set cannot be resolved using the specified named parameters.
     | One or more parameters issued cannot be used together or an insufficient
     | number of parameters were provided.

What do you think I'm missing here?

[navba-MSFT]

@zencifil Thanks for getting back. Could you please run the $DebugPreference="Continue" command and then run the above command and share the detailed output here ?