Merge pull request #24766 from MightyPen/xeventps-03

Updating Powershell script to new module AzureRm.

Author: rjagiewich

articles/sql-database/sql-database-xevent-code-event-file.md

@@ -15,7 +15,7 @@ ms.workload: data-management
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 02/06/2017
+ms.date: 10/04/2017
 ms.author: genemi
 
 ---
@@ -65,176 +65,165 @@ The script starts with commands to clean up after a possible previous run, and i
    * If you rerun the script without disrupting your session, you have the convenient option of commenting out the **Add-AzureAccount** command.
 
 ![PowerShell ISE, with Azure module installed, ready to run script.][30_powershell_ise]
-
+;
 
 ### PowerShell code
 
+This PowerShell script assumes you have already run the cmdlet Import-Module for the AzureRm module. For reference documentation, see [PowerShell Module Browser](https://docs.microsoft.com/powershell/module/).
+
 ```powershell
 ## TODO: Before running, find all 'TODO' and make each edit!!
 
-#--------------- 1 -----------------------
-
-
-# You can comment out or skip this Add-AzureAccount
-# command after the first run.
-# Current PowerShell environment retains the successful outcome.
-
-'Expect a pop-up window in which you log in to Azure.'
+cls;
 
+#--------------- 1 -----------------------
 
-Add-AzureAccount
+'Script assumes you have already logged your PowerShell session into Azure.
+But if not, run  Add-AzureRmAccount (or  Login-AzureRmAccount), just one time.';
+#Add-AzureRmAccount;   # Same as  Login-AzureRmAccount.
 
 #-------------- 2 ------------------------
 
-
 '
 TODO: Edit the values assigned to these variables, especially the first few!
-'
+';
 
 # Ensure the current date is between
 # the Expiry and Start time values that you edit here.
 
-$subscriptionName    = 'YOUR_SUBSCRIPTION_NAME'
-$policySasExpiryTime = '2016-01-28T23:44:56Z'
-$policySasStartTime  = '2015-08-01'
-
+$subscriptionName    = 'YOUR_SUBSCRIPTION_NAME';
+$resourceGroupName   = 'YOUR_RESOURCE-GROUP-NAME';
 
-$storageAccountName     = 'gmstorageaccountxevent'
-$storageAccountLocation = 'West US'
-$contextName            = 'gmcontext'
-$containerName          = 'gmcontainerxevent'
-$policySasToken         = 'gmpolicysastoken'
+$policySasExpiryTime = '2018-08-28T23:44:56Z';
+$policySasStartTime  = '2017-10-01';
 
+$storageAccountLocation = 'West US';
+$storageAccountName     = 'YOUR_STORAGE_ACCOUNT_NAME';
+$contextName            = 'YOUR_CONTEXT_NAME';
+$containerName          = 'YOUR_CONTAINER_NAME';
+$policySasToken         = ' ? ';
 
-# Leave this value alone, as 'rwl'.
-$policySasPermission = 'rwl'
+$policySasPermission = 'rwl';  # Leave this value alone, as 'rwl'.
 
 #--------------- 3 -----------------------
 
-
 # The ending display lists your Azure subscriptions.
 # One should match the $subscriptionName value you assigned
 #   earlier in this PowerShell script. 
 
-'Choose an existing subscription for the current PowerShell environment.'
-
-
-Select-AzureSubscription -SubscriptionName $subscriptionName
+'Choose an existing subscription for the current PowerShell environment.';
 
+Select-AzureRmSubscription -Subscription $subscriptionName;
 
 #-------------- 4 ------------------------
 
-
 '
 Clean up the old Azure Storage Account after any previous run, 
-before continuing this new run.'
-
+before continuing this new run.';
 
 If ($storageAccountName)
 {
-    Remove-AzureStorageAccount -StorageAccountName $storageAccountName
+    Remove-AzureRmStorageAccount `
+        -Name              $storageAccountName `
+        -ResourceGroupName $resourceGroupName;
 }
 
 #--------------- 5 -----------------------
 
-[System.DateTime]::Now.ToString()
+[System.DateTime]::Now.ToString();
 
 '
 Create a storage account. 
 This might take several minutes, will beep when ready.
-  ...PLEASE WAIT...'
-
-New-AzureStorageAccount `
-    -StorageAccountName $storageAccountName `
-    -Location           $storageAccountLocation
-
-[System.DateTime]::Now.ToString()
+  ...PLEASE WAIT...';
 
-[System.Media.SystemSounds]::Beep.Play()
+New-AzureRmStorageAccount `
+    -Name              $storageAccountName `
+    -Location          $storageAccountLocation `
+    -ResourceGroupName $resourceGroupName `
+    -SkuName           'Standard_LRS';
 
+[System.DateTime]::Now.ToString();
+[System.Media.SystemSounds]::Beep.Play();
 
 '
-Get the primary access key for your storage account.
-'
-
+Get the access key for your storage account.
+';
 
-$primaryAccessKey_ForStorageAccount = `
-    (Get-AzureStorageKey `
-        -StorageAccountName $storageAccountName).Primary
+$accessKey_ForStorageAccount = `
+    (Get-AzureRmStorageAccountKey `
+        -Name              $storageAccountName `
+        -ResourceGroupName $resourceGroupName
+        ).Value[0];
 
-"`$primaryAccessKey_ForStorageAccount = $primaryAccessKey_ForStorageAccount"
+"`$accessKey_ForStorageAccount = $accessKey_ForStorageAccount";
 
 'Azure Storage Account cmdlet completed.
 Remainder of PowerShell .ps1 script continues.
-'
+';
 
 #--------------- 6 -----------------------
 
-
 # The context will be needed to create a container within the storage account.
 
 'Create a context object from the storage account and its primary access key.
-'
+';
 
 $context = New-AzureStorageContext `
     -StorageAccountName $storageAccountName `
-    -StorageAccountKey  $primaryAccessKey_ForStorageAccount
-
+    -StorageAccountKey  $accessKey_ForStorageAccount;
 
 'Create a container within the storage account.
-'
-
+';
 
 $containerObjectInStorageAccount = New-AzureStorageContainer `
     -Name    $containerName `
-    -Context $context
-
+    -Context $context;
 
 'Create a security policy to be applied to the SAS token.
-'
+';
 
 New-AzureStorageContainerStoredAccessPolicy `
     -Container  $containerName `
     -Context    $context `
     -Policy     $policySasToken `
     -Permission $policySasPermission `
     -ExpiryTime $policySasExpiryTime `
-    -StartTime  $policySasStartTime 
+    -StartTime  $policySasStartTime;
 
 '
 Generate a SAS token for the container.
-'
+';
 Try
 {
     $sasTokenWithPolicy = New-AzureStorageContainerSASToken `
         -Name    $containerName `
         -Context $context `
-        -Policy  $policySasToken
+        -Policy  $policySasToken;
 }
 Catch 
 {
-    $Error[0].Exception.ToString()
+    $Error[0].Exception.ToString();
 }
 
 #-------------- 7 ------------------------
 
-
 'Display the values that YOU must edit into the Transact-SQL script next!:
-'
+';
 
-"storageAccountName: $storageAccountName"
-"containerName:      $containerName"
-"sasTokenWithPolicy: $sasTokenWithPolicy"
+"storageAccountName: $storageAccountName";
+"containerName:      $containerName";
+"sasTokenWithPolicy: $sasTokenWithPolicy";
 
 '
 REMINDER: sasTokenWithPolicy here might start with "?" character, which you must exclude from Transact-SQL.
-'
+';
 
 '
-(Later, return here to delete your Azure Storage account. See the preceding - Remove-AzureStorageAccount -StorageAccountName $storageAccountName)'
+(Later, return here to delete your Azure Storage account. See the preceding  Remove-AzureRmStorageAccount -Name $storageAccountName)';
 
 '
-Now shift to the Transact-SQL portion of the two-part code sample!'
+Now shift to the Transact-SQL portion of the two-part code sample!';
 
 # EOFile
 ```
@@ -266,7 +255,7 @@ The PowerShell script printed a few named values when it ended. You must edit th
 ### Transact-SQL code
 
 ```sql
----- TODO: First, run the PowerShell portion of this two-part code sample.
+---- TODO: First, run the earlier PowerShell portion of this two-part code sample.
 ---- TODO: Second, find every 'TODO' in this Transact-SQL file, and edit each.
 
 ---- Transact-SQL code for Event File target on Azure SQL Database.
@@ -544,6 +533,7 @@ For more info about accounts and containers in the Azure Storage service, see:
 * [Working with the Root Container](http://msdn.microsoft.com/library/azure/ee395424.aspx)
 * [Lesson 1: Create a stored access policy and a shared access signature on an Azure container](http://msdn.microsoft.com/library/dn466430.aspx)
   * [Lesson 2: Create a SQL Server credential using a shared access signature](http://msdn.microsoft.com/library/dn466435.aspx)
+* [Extended Events for Microsoft SQL Server](https://docs.microsoft.com/sql/relational-databases/extended-events/extended-events)
 
 <!--
 Image references.