After installing Azure Stack Development Kit (ASDK) or Azure Stack Integrated Systems, we need to add a default Windows Server 2016 or Linux Image. But before doing so, we have to complete a couple of tasks.
In this blog post, I will show you how to set up PowerShell for Azure Stack, then register Azure Stack with Azure subscription, and finally add a Windows Server 2016 image.
Set up PowerShell for Azure Stack
Login to Azure Stack Development Kit. Open an elevated PowerShell ISE session, and then run the following script:
# Set Execution & Repository policies $ResetExPol = Get-ExecutionPolicy Set-ExecutionPolicy Unrestricted -force Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted ### Install and Import AzureStack Modules 1.2.11 & Tools Install-Module -Name AzureRm.BootStrapper Use-AzureRmProfile -Profile 2017-03-09-profile -Force Install-Module -Name AzureStack -RequiredVersion 1.2.11 Import-Module -Name AzureStack -RequiredVersion 1.2.11 cd c:\ invoke-webrequest https://github.com/Azure/AzureStack-Tools/archive/master.zip -OutFile master.zip expand-archive master.zip -DestinationPath . -Force cd AzureStack-Tools-master Import-Module .\Connect\AzureStack.Connect.psm1 Import-Module .\ComputeAdmin\AzureStack.ComputeAdmin.psm1 ### Reset Execution Policy back to default Set-ExecutionPolicy $ResetExPol -Force ### Specify Azure Active Directory tenant name. $TenantName = "directoryname.onmicrosoft.com" # Specify Azure Active Directory Name ### For Azure Stack development kit, this value is set to https://adminmanagement.local.azurestack.external. $ArmEndpoint = "https://adminmanagement.local.azurestack.external" ### For Azure Stack development kit, this value is adminvault.local.azurestack.external $KeyvaultDnsSuffix = “adminvault.local.azurestack.external” ### Register an AzureRM environment that targets your Azure Stack instance Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint $ArmEndpoint ### Get the Active Directory tenantId that is used to deploy Azure Stack $TenantID = Get-AzsDirectoryTenantId -AADTenantName $TenantName -EnvironmentName "AzureStackAdmin" ### Sign in to Azure Stack environment Login-AzureRmAccount -EnvironmentName "AzureStackAdmin" -TenantId $TenantID
Here’s a quick overview of what the script above is doing:
- Set PowerShell Execution and PowerShell repository
- Install and import AzureStack Modules version 1.2.11
- Download and install AzureStack-Tools
- Import Azure Stack connect and compute modules
- Reset PowerShell Execution Policy back to default
- Register Azure Resource Manager (AzureRM) environment with Azure Stack Instance
- Login to Azure Stack environment
Now that you have set up PowerShell for Azure Stack, I will keep PowerShell ISE console open for the time being, we’ll be using it in the subsequent sections.
If you want to confirm that everything is working as expected, you can test the configuration by creating a test resource group by running the command below:
### Test Azure Stack Connectivity by creating a Resource Group New-AzureRMResourceGroup -Name "Test-ASDK-RG01" -Location Local
After the resource group is created, the Provisioning state property is set to Succeeded as shown in the next screenshot.
Register Azure Stack with Azure Subscription
This is step is not required, but it’s recommended because it enables you to test and download Azure marketplaces items from public Azure (known as Marketplace Syndication).
Before you start registering Azure Stack with Azure, you must have a subscription ID for an active Azure subscription.
Log into your Azure Subscription at https://portal.azure.com and grab your subscription ID that you want to register with Azure Stack. You might have multiple subscriptions.
Once you have the subscription ID, login to the Azure Stack host computer and run the following PowerShell script to register Azure Stack with Azure.
### Register Azure Stack Resource Provider with Azure # This step only needs to be completed once in an Azure Stack environment Login-AzureRmAccount -EnvironmentName "AzureCloud" Register-AzureRmResourceProvider -ProviderNamespace Microsoft.AzureStack ### Register Azure Stack Environment with Azure # Specify Azure Active Directory Name $AADTenantName = "directoryname.onmicrosoft.com" $ASDKAdminCred = Get-Credential ("AzureStack\AzureStackAdmin") # Specify Azure Subscription ID that you want to use $AzureSubscriptionID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" # This should be the IP address for the Azs-ECRS01 VM that's deployed as part of ASDK $PrivilegedEndpoint = "192.168.200.225" ### Import the Register With Azure Module cd C:\AzureStack-Tools-master\Registration Import-Module .\RegisterWithAzure.psm1 -Verbose ### Run the Azure registration cmdlet Add-AzsRegistration ` -CloudAdminCredential $ASDKAdminCred ` -AzureDirectoryTenantName $AADTenantName ` -AzureSubscriptionId $AzureSubscriptionID ` -PrivilegedEndpoint $PrivilegedEndpoint ` -BillingModel Development
Here’s a quick overview of what the script above is doing:
- Logs into your Azure account. You’ll be prompted for credentials, enter the credentials of a Global Administrator for your subscription
- Registers the “Microsoft.AzureStack” resource provider with your Azure account
- Specify the AAD Tenant Name, Azure Stack admin credentials, Azure Subscription ID and the IP address for the Privileged Endpoint VM that was deployed as part of Azure Stack
- Import the Register With Azure Module
- Finally, activating Azure Stack with Azure (this may take up to 10 minutes to complete)
Add Windows Server 2016 Image to Azure Stack
In the final section, we will download and add Windows Server image from Azure to Azure Stack. This step requires that you have registered your Azure Stack instanced with Azure. If you have deployed Azure Stack in a disconnected scenario, or in scenarios with limited connectivity, the check the following article on how to add the image in offline mode by using PowerShell.
- Log into your Azure Stack Development Kit portal at: https://adminportal.local.azurestack.external/
- Select More services > Marketplace Management > Click on +Add from Azure. (You should now be presented with a populated Marketplace items)
- Search for the Windows Server 2016 Datacenter – Eval image
- Select the image and click Download. The image download size is 40GB, so it will take some time to complete.
- When the download is finished successfully, you can see the image is available under Marketplace management. The image also is available under Virtual machines.
That’s it there you have it. You can now start provisioning virtual machines… Until then, see you in the next post!
Thanks for reading!