Merge pull request #37938 from mattbriggs/mdb_PowerShell2018_4020_update

Update Docs for PowerShell update April 20

articles/active-directory/active-directory-enterprise-app-role-management.md

@@ -51,7 +51,7 @@ If your application expects custom roles to be passed in SAML response, you need
 
 5. Once the application is added, go to **Properties** page and copy the **Object ID**.
 
-	![Properties Page](./media/active-directory-enterprise-app-role-management/tutorial_app_properties.PNG)
+<!-- ![Properties Page](./media/active-directory-enterprise-app-role-management/tutorial_app_properties.png) Note: Image is missing. -->
 
 6. Open [Azure AD Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) in another window.
 

articles/azure-stack/TOC.yml

@@ -111,8 +111,7 @@
         href: azure-stack-powershell-download.md
       - name: Configure PowerShell - Cloud operator
         href: azure-stack-powershell-configure-admin.md
-      - name: Get up and running with PowerShell
-        href: azure-stack-powershell-configure-quickstart.md
+
     - name: Access privileged endpoint
       href: azure-stack-privileged-endpoint.md
     - name: Manage updates

articles/azure-stack/asdk/asdk-marketplace-item-offline.md

@@ -11,10 +11,10 @@ ms.assetid:
 ms.service: azure-stack
 ms.workload: na
 pms.tgt_pltfrm: na
-ms.devlang: na
+ms.devlang: PowerShell
 ms.topic: tutorial
 ms.custom: mvc
-ms.date: 03/16/2018
+ms.date: 04/20/2018
 ms.author: jeffgilb
 ms.reviewer: misainat
 ---

articles/azure-stack/azure-stack-backup-back-up-azure-stack.md

@@ -13,8 +13,9 @@ ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 12/15/2017
+ms.date: 5/08/2017
 ms.author: mabrigg
+ms.reviewer: hectorl
 
 ---
 # Back up Azure Stack
@@ -24,19 +25,13 @@ ms.author: mabrigg
 Perform an on-demand backup on Azure Stack with backup in place. If you need to enable the Infrastructure Backup Service, see [Enable Backup for Azure Stack from the administration portal](azure-stack-backup-enable-backup-console.md).
 
 > [!Note]  
->  Azure Stack Tools contain the **Start-AzSBackup** cmdlet. For instructions on installing the tools, see [Get up and running with PowerShell in Azure Stack](https://docs.microsoft.com/azure/azure-stack/azure-stack-powershell-configure-quickstart).
+>  For instructions on configuring the PowerShell environment, see [Install PowerShell for Azure Stack ](azure-stack-powershell-install.md).
 
 ## Start Azure Stack backup
 
 Open Windows PowerShell with an elevated prompt in the operator management environment, and run the following commands:
 
 ```powershell
-    cd C:\tools\AzureStack-Tools-master\Connect
-    Import-Module .\AzureStack.Connect.psm1
-
-    cd C:\tools\AzureStack-Tools-master\Infrastructure
-    Import-Module .\AzureStack.Infra.psm1 
-    
     Start-AzSBackup -Location $location.Name
 ```
 
@@ -47,7 +42,11 @@ Open Windows PowerShell with an elevated prompt in the operator management envir
 3. Find the **Name** and **Date Completed** of the backup in **Available backups** list.
 4. Verify the **State** is **Succeeded**.
 
-You can also confirm the backup completed from the administration portal. Navigate to `\MASBackup\<datetime>\<backupid>\BackupInfo.xml`
+<!-- You can also confirm the backup completed from the administration portal. Navigate to `\MASBackup\<datetime>\<backupid>\BackupInfo.xml`
+
+In ‘Confirm backup completed’ section, the path at the end doesn’t make sense (ie relative to what, datetime format, etc?)
+\MASBackup\<datetime>\<backupid>\BackupInfo.xml -->
+
 
 ## Next steps
 

articles/azure-stack/azure-stack-backup-best-practices.md

@@ -13,8 +13,9 @@ ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 12/27/2017
+ms.date: 4/20/2017
 ms.author: mabrigg
+ms.reviewer: hectorl
 
 ---
 # Infrastructure Backup Service best practices

articles/azure-stack/azure-stack-backup-enable-backup-powershell.md

@@ -7,80 +7,45 @@ author: mattbriggs
 manager: femila
 editor: ''
 
-ms.assetid: 7DFEFEBE-D6B7-4BE0-ADC1-1C01FB7E81A6
 ms.service: azure-stack
 ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 12/15/2017
+ms.date: 5/10/2018
 ms.author: mabrigg
+ms.reviewer: hectorl
 
 ---
 # Enable Backup for Azure Stack with PowerShell
 
 *Applies to: Azure Stack integrated systems and Azure Stack Development Kit*
 
-Enable the Infrastructure Backup Service with Windows PowerShell so that Azure Stack can be restored if there is a failure. You can access the PowerShell cmdlets to enable backup, start backup, and get backup information via the operator management endpoint.
+Enable the Infrastructure Backup Service with Windows PowerShell so take periodic backups of:
+ - Internal identity service and root certificate
+ - User plans, offers, subscriptions
+ - Keyvault secrets
+ - User RBAC roles and policies
 
-## Download Azure Stack Tools
+You can access the PowerShell cmdlets to enable backup, start backup, and get backup information via the operator management endpoint.
 
-Install and configured PowerShell for Azure Stack and the Azure Stack tools. See [Get up and running with PowerShell in Azure Stack](https://docs.microsoft.com/azure/azure-stack/azure-stack-powershell-configure-quickstart).
+## Prepare PowerShell environment
 
-##  Load the Connect and Infrastructure modules
+For instructions on configuring the PowerShell environment, see [Install PowerShell for Azure Stack ](azure-stack-powershell-install.md).
 
-Open Windows PowerShell with an elevated prompt, and run the following commands:
+## Generate a new encryption key
+
+Install and configured PowerShell for Azure Stack and the Azure Stack tools.
+ - See [Get up and running with PowerShell in Azure Stack](https://docs.microsoft.com/azure/azure-stack/azure-stack-powershell-configure-quickstart).
+ - See [Download Azure Stack tools from GitHub](azure-stack-powershell-download.md)
 
+Open Windows PowerShell with an elevated prompt, and run the following commands:
+
    ```powershell
-    cd C:\tools\AzureStack-Tools-master\Connect
-    Import-Module .\AzureStack.Connect.psm1
-    
     cd C:\tools\AzureStack-Tools-master\Infrastructure
     Import-Module .\AzureStack.Infra.psm1 
-    
    ```
-
-##  Setup Rm environment and log into the operator management endpoint
-
-In the same PowerShell session, Edit the following PowerShell script by adding the variables for your environment. Run the updated script to set up the RM environment and log into the operator management endpoint.
-
-| Variable    | Description |
-|---          |---          |
-| $TenantName | Azure Active Directory tenant name. |
-| Operator account name        | Your Azure Stack operator account name. |
-| Azure Resource Manager Endpoint | URL to the Azure Resource Manager. |
-
-   ```powershell
-   # Specify Azure Active Directory tenant name
-    $TenantName = "contoso.onmicrosoft.com"
-    
-    # Set the module repository and the execution policy
-    Set-PSRepository `
-      -Name "PSGallery" `
-      -InstallationPolicy Trusted
-    
-    Set-ExecutionPolicy RemoteSigned `
-      -force
-    
-    # Configure the Azure Stack operator’s PowerShell environment.
-    Add-AzureRMEnvironment `
-      -Name "AzureStackAdmin" `
-      -ArmEndpoint "https://adminmanagement.seattle.contoso.com"
-    
-    Set-AzureRmEnvironment `
-      -Name "AzureStackAdmin" `
-      -GraphAudience "https://graph.windows.net/"
-    
-    $TenantID = Get-AzsDirectoryTenantId `
-      -AADTenantName $TenantName `
-      -EnvironmentName AzureStackAdmin
-    
-    # Sign-in to the operator's console.
-    Add-AzureRmAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantID 
-    
-   ```
-## Generate a new encryption key
-
+
 In the same PowerShell session, run the following commands:
 
    ```powershell
@@ -133,4 +98,4 @@ The result should look like the following JSON output:
 ## Next steps
 
  - Learn to run a backup, see [Back up Azure Stack](azure-stack-backup-back-up-azure-stack.md ).  
-- Learn to verify that your backup ran, see [Confirm backup completed in administration portal](azure-stack-backup-back-up-azure-stack.md ).
+ - Learn to verify that your backup ran, see [Confirm backup completed in administration portal](azure-stack-backup-back-up-azure-stack.md ).

articles/azure-stack/azure-stack-backup-infrastructure-backup.md

@@ -13,8 +13,9 @@ ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 12/15/2017
+ms.date: 4/20/2017
 ms.author: mabrigg
+ms.reviewer: hectorl
 
 ---
 # Backup and data recovery for Azure Stack with the Infrastructure Backup Service

articles/azure-stack/azure-stack-backup-recover-data.md

@@ -13,8 +13,9 @@ ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 02/13/2017
+ms.date: 4/20/2017
 ms.author: mabrigg
+ms.reviewer: hectorl
 
 ---
 # Recover from catastrophic data loss

articles/azure-stack/azure-stack-backup-reference.md

@@ -13,8 +13,9 @@ ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 12/15/2017
+ms.date: 4/20/2017
 ms.author: mabrigg
+ms.reviewer: hectorl
 
 ---
 # Infrastructure Backup Service reference

articles/azure-stack/azure-stack-compute-add-scalesets.md

@@ -6,13 +6,12 @@ author: brenduns
 manager: femila
 editor: ''
 
-ms.assetid:
 ms.service: azure-stack
 ms.topic: article
-ms.date: 04/06/2018
+ms.date: 05/08/2018
 ms.author: brenduns
-ms.reviewer: anajod
-keywords:
+ms.reviewer: kivenkat
+
 ---
 
 # Make virtual machine scale sets available in Azure Stack
@@ -35,14 +34,15 @@ On Azure Stack, virtual machine scale sets don't support auto-scale. You can add
    Install and configured PowerShell for Azure Stack and the Azure Stack tools. See [Get up and running with PowerShell in Azure Stack](azure-stack-powershell-configure-quickstart.md).
 
    After you install the Azure Stack tools, make sure you import the following PowerShell module (path relative to the .\ComputeAdmin folder in the AzureStack-Tools-master folder):
-
+  ````PowerShell
         Import-Module .\AzureStack.ComputeAdmin.psm1
+  ````
 
 * **Operating system image**
 
    If you haven’t added an operating system image to your Azure Stack Marketplace, see [Add the Windows Server 2016 VM image to the Azure Stack marketplace](azure-stack-add-default-image.md).
 
-   For Linux support, download Ubuntu Server 16.04 and add it using ```Add-AzsVMImage``` with the following parameters: ```-publisher "Canonical" -offer "UbuntuServer" -sku "16.04-LTS"```.
+   For Linux support, download Ubuntu Server 16.04 and add it using ```Add-AzsPlatformImage``` with the following parameters: ```-publisher "Canonical" -offer "UbuntuServer" -sku "16.04-LTS"```.
 
 
 ## Add the virtual machine scale set
@@ -51,7 +51,7 @@ Edit the following PowerShell script for your environment and then run it to add
 
 ``$User`` is the account you use to connect the administrator portal. For example, [email protected].
 
-```
+````PowerShell  
 $Arm = "https://adminmanagement.local.azurestack.external"
 $Location = "local"
 
@@ -69,7 +69,7 @@ $AzsEnvContext = Add-AzureRmAccount -Environment $AzsEnv -Credential $Creds
 Select-AzureRmSubscription -SubscriptionName "Default Provider Subscription"
 
 Add-AzsVMSSGalleryItem -Location $Location
-```
+````
 
 ## Update images in a virtual machine scale set 
 After you create a virtual machine scale set, users can update images in the scale set without the scale set having to be recreated. The process to update an image depends on the following scenarios:
@@ -80,12 +80,14 @@ After you create a virtual machine scale set, users can update images in the sca
 
    The following is an example of specifying *latest*:  
 
-          "imageReference": {
-             "publisher": "[parameters('osImagePublisher')]",
-             "offer": "[parameters('osImageOffer')]",
-             "sku": "[parameters('osImageSku')]",
-             "version": "latest"
-             }
+    ```Json  
+    "imageReference": {
+        "publisher": "[parameters('osImagePublisher')]",
+        "offer": "[parameters('osImageOffer')]",
+        "sku": "[parameters('osImageSku')]",
+        "version": "latest"
+        }
+    ```
 
    Before scale up can use a new image, you must download that new image:  
 
@@ -107,12 +109,12 @@ For more information, see [operating system disks and images](.\user\azure-stack
 
 To remove a virtual machine scale set gallery item, run the following PowerShell command:
 
+```PowerShell  
     Remove-AzsVMSSGalleryItem
+````
 
 > [!NOTE]
 > The gallery item may not be removed immediately. You night need to refresh the portal several times before the item shows as removed from the Marketplace.
 
-
 ## Next steps
-[Frequently asked questions for Azure Stack](azure-stack-faq.md)
-
+[Frequently asked questions for Azure Stack](azure-stack-faq.md)

articles/azure-stack/azure-stack-create-and-publish-marketplace-item.md

@@ -7,13 +7,12 @@ author: brenduns
 manager: femila
 editor: ''
 
-ms.assetid: 77e5f60c-a86e-4d54-aa8d-288e9a889386
 ms.service: azure-stack
 ms.workload: na
 ms.tgt_pltfrm: na
 ms.devlang: na
 ms.topic: article
-ms.date: 08/21/2017
+ms.date: 05/10/2018
 ms.author: brenduns
 ms.reviewer: jeffgo