Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Set Azure Resource Manager password on your Azure Stack Edge Pro GPU device description: Describes set the Azure Resource Manager password on your Azure Stack Edge Pro GPU using Azure PowerShell. services: databox author: alkohli ms.service: azure-stack-edge ms.custom: devx-track-azurepowershell, devx-track-arm-template ms.topic: how-to ms.date: 02/21/2021 ms.author: alkohli #Customer intent: As an IT admin, I need to understand how to connect to Azure Resource Manager on my Azure Stack Edge Pro device so that I can manage resources. --- # Set Azure Resource Manager password on Azure Stack Edge Pro GPU device [!INCLUDE [applies-to-GPU-and-pro-r-and-mini-r-skus](../../includes/azure-stack-edge-applies-to-gpu-pro-r-mini-r-sku.md)] This article describes how to set your Azure Resource Manager password. You need to set this password when you are [connecting to the device local APIs via the Azure Resource Manager](azure-stack-edge-gpu-connect-resource-manager.md). <!--The procedure to set the password can be different depending upon whether you use the Azure portal or the PowerShell cmdlets. Each of these procedures is described in the following sections.--> ## Reset password via the Azure portal 1. In the Azure portal, go to the Azure Stack Edge resource you created to manage your device. 2. Go to **Properties**. In the right pane, from the command bar, select **Reset Edge ARM password**.  3. In the **Reset EdgeArm user password** blade, provide a password to connect to your device local APIs via the Azure Resource Manager. Confirm the password and select **Reset**.  <!--## Reset password via PowerShell 1. In the Azure Portal, go to the Azure Stack Edge resource you created to manage your device. Make a note of the following parameters in the **Overview** page. - Azure Stack Edge resource name - Subscription ID 2. Go to **Settings > Properties**. Make a note of the following parameters in the **Properties** page. - Resource group - CIK encryption key: Select view and then copy the **Encryption Key**.  3. Identify a password that you will use to connect to Azure Resource Manager. 4. Start the cloud shell. Select on the icon in the top right corner:  Once the cloud shell has started, you may need to switch to PowerShell.  5. Set context. Type: `Set-AzContext -SubscriptionId <Subscription ID>` Here is a sample output: ```azurepowershell PS Azure:\> Set-AzContext -SubscriptionId aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e Name Account SubscriptionName Environment TenantId ---- ------- ---------------- ----------- -------- DataBox_Edge_Test (8eb87630-972c-4c36-a… MSI@50342 DataBox_Edge_Tes AzureCloud 72f988bf-86f1-41af-91ab-2d7… PS Azure:/ ``` 5. If you have any old PS modules, you need to install those. `Remove-Module Az.DataBoxEdge -force` Here is a sample output. In this example, there were no old modules to be installed. ```azurepowershell PS Azure:\> Remove-Module Az.DataBoxEdge -force Remove-Module : No modules were removed. Verify that the specification of modules to remove is correct and those modules exist in the runspace. At line:1 char:1 + Remove-Module Az.DataBoxEdge -force + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : ResourceUnavailable: (:) [Remove-Module], InvalidOperationException + FullyQualifiedErrorId : Modules_NoModulesRemoved,Microsoft.PowerShell.Commands.RemoveModuleCommand PS Azure:\ ``` 6. Next set of commands will download and run a script to install PowerShell modules. ```azurepowershell cd ~/clouddrive wget https://aka.ms/dbe-cmdlet-beta -O Az.DataBoxEdge.zip unzip ./Az.DataBoxEdge.zip Import-Module ~/clouddrive/Az.DataBoxEdge/Az.DataBoxEdge.psd1 -Force ``` 7. In the next set of commands, you'll need to provide the resource name, resource group name, encryption key, and the password you identified in the previous step. ```azurepowershell $devicename = "<Azure Stack Edge resource name>" $resourceGroup = "<Resource group name>" $cik = "<Encryption key>" $password = "<Password>" ``` The password and encryption key parameters must be passed as secure strings. Use the following cmdlets to convert the password and encryption key to secure strings. ```azurepowershell $pass = ConvertTo-SecureString $password -AsPlainText -Force $key = ConvertTo-SecureString $cik -AsPlainText -Force ``` Use the above generated secure strings as parameters in the Set-AzDataBoxEdgeUser cmdlet to reset the password. Use the same resource group that you used when creating the Azure Stack Edge Pro/Data Box Gateway resource. ```azurepowershell Set-AzDataBoxEdgeUser -ResourceGroupName $resourceGroup -DeviceName $devicename -Name EdgeARMUser -Password $pass -EncryptionKey $key ``` Here is the sample output. ```azurepowershell PS /home/aseuser/clouddrive> $devicename = "myaseresource" PS /home/aseuser/clouddrive> $resourceGroup = "myaserg" PS /home/aseuser/clouddrive> $cik = "54a7450fd7b3c506e10efea4e0c88a9390f37e299fbf43e01fb5dfe483ac036b6d0f85a6246e1926e297f98c0ff84c20a57348c689eff179ce31571fc787ac0a" PS /home/aseuser/clouddrive> $password = "Password2" PS /home/aseuser/clouddrive> $pass = ConvertTo-SecureString $password -AsPlainText -Force PS /home/aseuser/clouddrive> $key = ConvertTo-SecureString $cik -AsPlainText -Force PS /home/aseuser/clouddrive> Set-AzDataBoxEdgeUser -ResourceGroupName $resourceGroup -DeviceName $devicename -Name EdgeARMUser -Password $pass -EncryptionKey $key User name Type ResourceGroupName DeviceName --------- ---- ----------------- ---------- EdgeARMUser ARM myaserg myaseresource PS /home/aseuser/clouddrive> ``` Use the new password to connect to Azure Resource Manager.--> ## Next steps [Connect to Azure Resource Manager](azure-stack-edge-gpu-connect-resource-manager.md)