Merge pull request #178915 from whhender/data-share-ps-guide

Adding PS guide to Data Share tutorials

Author: laurabren

articles/data-share/share-your-data.md

@@ -5,7 +5,7 @@ author: jifems
 ms.author: jife
 ms.service: data-share
 ms.topic: tutorial
-ms.date: 03/24/2021
+ms.date: 11/12/2021
 ---
 # Tutorial: Share data using Azure Data Share  
 
@@ -22,13 +22,13 @@ In this tutorial, you'll learn how to:
 ## Prerequisites
 
 * Azure Subscription: If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
-* Your recipient's Azure login e-mail address (using their e-mail alias won't work).
+* Your recipient's Azure e-mail address (using their e-mail alias won't work).
 * If the source Azure data store is in a different Azure subscription than the one you will use to create Data Share resource, register the [Microsoft.DataShare resource provider](concepts-roles-permissions.md#resource-provider-registration) in the subscription where the Azure data store is located. 
 
 ### Share from a storage account
 
 * An Azure Storage account: If you don't already have one, you can create an [Azure Storage account](../storage/common/storage-account-create.md)
-* Permission to write to the storage account, which is present in *Microsoft.Storage/storageAccounts/write*. This permission exists in the **Contributor** role.
+* Permission to write to the storage account, which is present in *Microsoft.Storage/storageAccounts/write*. This permission exists in the **Storage Blob Data Contributor** role.
 * Permission to add role assignment to the storage account, which is present in *Microsoft.Authorization/role assignments/write*. This permission exists in the **Owner** role. 
 
 
@@ -42,9 +42,9 @@ Below is the list of prerequisites for sharing data from SQL source.
 * **Azure Active Directory Admin** of the SQL server
 * SQL Server Firewall access. This can be done through the following steps: 
     1. In Azure portal, navigate to SQL server. Select *Firewalls and virtual networks* from left navigation.
-    1. Click **Yes** for *Allow Azure services and resources to access this server*.
-    1. Click **+Add client IP**. Client IP address is subject to change. This process might need to be repeated the next time you are sharing SQL data from Azure portal. You can also add an IP range.
-    1. Click **Save**. 
+    1. Select **Yes** for *Allow Azure services and resources to access this server*.
+    1. Select **+Add client IP**. Client IP address is subject to change. This process might need to be repeated the next time you are sharing SQL data from Azure portal. You can also add an IP range.
+    1. Select **Save**. 
 
 #### Prerequisites for sharing from Azure Synapse Analytics (workspace) SQL pool
 
@@ -59,13 +59,13 @@ Below is the list of prerequisites for sharing data from SQL source.
         create user "<share_acct_name>" from external provider;     
         exec sp_addrolemember db_datareader, "<share_acct_name>"; 
         ```                   
-       Note that the *<share_acc_name>* is the name of your Data Share resource. If you have not created a Data Share resource as yet, you can come back to this pre-requisite later.  
+       The *<share_acc_name>* is the name of your Data Share resource. If you have not created a Data Share resource as yet, you can come back to this pre-requisite later.  
 
 * Synapse workspace Firewall access. This can be done through the following steps: 
     1. In Azure portal, navigate to Synapse workspace. Select *Firewalls* from left navigation.
-    1. Click **ON** for *Allow Azure services and resources to access this workspace*.
-    1. Click **+Add client IP**. Client IP address is subject to change. This process might need to be repeated the next time you are sharing SQL data from Azure portal. You can also add an IP range.
-    1. Click **Save**. 
+    1. Select **ON** for *Allow Azure services and resources to access this workspace*.
+    1. Select **+Add client IP**. Client IP address is subject to change. This process might need to be repeated the next time you are sharing SQL data from Azure portal. You can also add an IP range.
+    1. Select **Save**. 
 
 
 ### Share from Azure Data Explorer
@@ -142,6 +142,48 @@ Use these commands to create the resource:
    az datashare account list --resource-group testresourcegroup
    ```
 
+### [PowerShell](#tab/powershell)
+
+Create an Azure Data Share resource in an Azure resource group.
+
+Start by preparing your environment for PowerShell. You can either run PowerShell commands locally or using the Bash environment in the Azure Cloud Shell.
+
+[!INCLUDE [azure-powershell-requirements-no-header.md](../../includes/azure-powershell-requirements-no-header.md)]
+
+   [![Launch Cloud Shell in a new window](../../includes/media/cloud-shell-try-it/hdi-launch-cloud-shell.png)](https://shell.azure.com)
+
+Use these commands to create the resource:
+
+1. Use the [Connect-AzAccount](/powershell/module/az.accounts/connect-azaccount) command to connect to your Azure account.
+
+    ```azurepowershell
+    Connect-AzAccount
+    ```
+
+1. Run the [Set-AzContext](/powershell/module/az.accounts/set-azcontext) command to set the correct subscription, if you have multiple subscriptions.
+
+    ```azurepowershell
+    Set-AzContext [SubscriptionID/SubscriptionName]
+    ```
+
+1. Run the [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) command to create a resource group, or use an existing resource group:
+
+    ```azurepowershell
+    New-AzResourceGroup -Name <String> -Location <String>
+    ```
+
+1. Run the [New-AzDataShare](/powershell/module/az.datashare/new-azdatashareaccount) command to create a Data Share account:
+
+   ```azurepowershell
+    New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
+   ```
+
+   Run the [Get-AzDataShareAccount](/powershell/module/az.datashare/get-azdatashareaccount) command to see your Data Share accounts:
+
+   ```azurecli
+   Get-AzDataShareAccount
+   ```
+
 ---
 
 ## Create a share
@@ -192,13 +234,13 @@ Use these commands to create the resource:
 
 ### [Azure CLI](#tab/azure-cli)
 
-1. Run the [az storage account create](/cli/azure/storage/account#az_storage_account_create) command to create a Data Share:
+1. Run the [az storage account create](/cli/azure/storage/account#az_storage_account_create) command to create a Storage account for this Data Share:
 
    ```azurecli
    az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
    ```
 
-1. Use the [az storage container create](/cli/azure/storage/container#az_storage_container_create) command to create a container for the share in the previous command:
+1. Use the [az storage container create](/cli/azure/storage/container#az_storage_container_create) command to create a container inside the storage account created in the previous command:
 
    ```azurecli
    az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
@@ -220,6 +262,53 @@ Use these commands to create the resource:
      --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam"
    ```
 
+### [PowerShell](#tab/powershell)
+
+1. If you do not already have data you would like to share, you can follow these steps to create a storage account. If you already have storage, you may skip to step 2.
+
+    1. Run the [New-AzStorageAccount](/powershell/module/az.storage/new-azstorageaccount) command to create an Azure Storage account:
+
+       ```azurepowershell
+       $storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>
+
+       $ctx = $storageAccount.Context
+       ```
+
+    1. Run the [New-AzStorageContainer](/powershell/module/az.storage/new-azstoragecontainer) command to create a container in your new Azure Storage account that will hold your data:
+
+       ```azurepowershell
+       $containerName = <String>
+
+       New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
+       ```
+
+    1. Run the [Set-AzStorageBlobContent](/powershell/module/az.storage/new-azstoragecontainer) command to upload a file. The follow example uploads _textfile.csv_ from the _D:\testFiles_ folder on local memory, to the container you created.
+               
+       ```azurepowershell
+       Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
+       ```
+
+    For more information about working with Azure Storage in PowerShell, follow this [Azure Storage PowerShell guide](../storage/blobs/storage-quickstart-blobs-powershell.md).
+
+
+1. Run the [New-AzDataShare](/powershell/module/az.datashare/new-azdatashare) command to create your Data Share:
+
+   ```azurepowershell
+   New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -ShareKind "CopyBased" -Description <String> -TermsOfUse <String>
+   ```
+
+1. Use the [New-AzDataShareInvitation](/powershell/module/az.datashare/get-azdatasharereceivedinvitation) command to create the invitation for the specified address:
+
+   ```azurepowershell
+   New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>
+   ```
+
+1. Use the [New-AzDataShareSynchronizationSetting](/powershell/module/az.datashare/new-azdatasharesynchronizationsetting) command to set a synchronization recurrence for your share. This can be daily, hourly, or at a particular time.
+
+   ```azurepowershell
+   New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
+   ```
+
 ---
 
 Your Azure Data Share has now been created and the recipient of your Data Share is now ready to accept your invitation.
@@ -230,7 +319,7 @@ When the resource is no longer needed, go to the **Data Share Overview** page an
 
 ## Next steps
 
-In this tutorial, you learnt how to create an Azure Data Share and invite recipients. To learn about how a Data Consumer can accept and receive a data share, continue to the accept and receive data tutorial.
+In this tutorial, you learned how to create an Azure Data Share and invite recipients. To learn about how a Data Consumer can accept and receive a data share, continue to the accept and receive data tutorial.
 
 > [!div class="nextstepaction"]
 > [Tutorial: Accept and receive data using Azure Data Share](subscribe-to-data-share.md)