By default, there aren’t any virtual machine images available in the Azure stack marketplace. The administrator must add a Virtual Machine image to the Azure Stack marketplace before users can create them. This topic describes the steps required to add a Windows Server 2016 image to the marketplace by using PowerShell. The steps described in this topic are helpful if you have deployed your Azure Stack instance in a disconnected scenario.
If you are operating in a connected scenario and if you have registered your Azure Stack instance with Azure, then you can download the Windows Server 2016 VM image from the Azure Marketplace by using the steps described in the Download marketplace items from Azure to Azure Stack topic.
After deploying Azure Stack, sign in to the MAS-CON01 virtual machine.
Go to https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2016 and download the Windows Server 2016 evaluation. When prompted, select the ISO version of the download. Record the path to the download location, which is used later in these steps.
Open PowerShell ISE as an administrator.
Download the Azure Stack tools from GitHub. Make sure that you download and extract the Azure Stack tool repository to a folder that is NOT under the C:\Windows\System32 directory.
Import the Azure Stack Connect and ComputeAdmin modules by using the following commands:
Import-Module .\Connect\AzureStack.Connect.psm1 Import-Module .\ComputeAdmin\AzureStack.ComputeAdmin.psm1
Create the Azure Stack administrator's AzureRM environment by using the following cmdlet:
Add-AzureStackAzureRmEnvironment ` -Name "AzureStackAdmin" ` -ArmEndpoint "https://adminmanagement.local.azurestack.external"
Get the GUID value of the Active Directory(AD) tenant that is used to deploy the Azure Stack. If your Azure Stack environment is deployed by using:
a. Azure Active Directory, use the following cmdlet:
$TenantID = Get-DirectoryTenantID ` -AADTenantName "<myaadtenant>.onmicrosoft.com" ` -EnvironmentName AzureStackAdmin
b. Active Directory Federation Services, use the following cmdlet:
$TenantID = Get-DirectoryTenantID ` -ADFS -EnvironmentName AzureStackAdmin
Add the Windows Server 2016 image to the Azure Stack marketplace by running the
New-Server2016VMImagecmdlet. Replace Path_to_ISO with the path to the WS2016 ISO you downloaded. See the Parameters section for information about the allowed parameters.
$ISOPath = "<Fully_Qualified_Path_to_ISO>" # Store the service administrator account credentials in a variable $UserName='<Username of the service administrator account>' $Password='<Admin password provided when deploying Azure Stack>'| ` ConvertTo-SecureString -Force -AsPlainText $Credential=New-Object PSCredential($UserName,$Password) # Add a Windows Server 2016 Evaluation VM Image. New-Server2016VMImage ` -ISOPath $ISOPath ` -TenantId $TenantID ` -EnvironmentName "AzureStackAdmin" ` -Net35 $True ` -AzureStackCredentials $Credential
To ensure that the Windows Server 2016 VM image has the latest cumulative update, include the
IncludeLatestCUparameter when running the previous cmdlet.
When you run the
New-Server2016VMImagecmdlet, the output displays a warning message that says, “Unable to acquire token for tenant ‘Common’”, which you can ignore and the download continues. The output also displays the “Downloading” message for a while and if the download is successful, it ends with the “StatusCode: Created” message.
|ArmEndpoint||No||The Azure Resource Manager endpoint for your Azure Stack environment. The default is the one used by the Proof of Concept (PoC) environment.|
|AzureStackCredentials||Yes||The credentials provided during deployment that are used to sign in to the Azure Stack Administrator portal.|
|EnvironmentName||yes||The Azure Stack administrator's PowerShell environment name.|
|IncludeLatestCU||No||Set this switch to apply the latest Windows Server 2016 cumulative update to the new VHD.|
|ISOPath||Yes||The full path to the downloaded Windows Server 2016 ISO.|
|Net35||No||This parameter allows you to install the .NET 3.5 runtime on the Windows Server 2016 image. By default, this value is set to true. It is mandatory that the image contains the .NET 3.5 runtime to install the SQL or MYSQL resource providers.|
|TenantID||Yes||The GUID value of your Azure Stack Tenant ID.|
|Version||No||This parameter allows you to choose whether to add a Core or Full (or both) Windows Server 2016 images. Valid values include Full (the default this parameter is not provided), Core, and Both.|
|VHDSizeInMB||No||Sets the size (in MB) of the VHD image to be added to your Azure Stack environment. Default value is 40960 MB.|
|CreateGalleryItem||No||Specifies if a Marketplace item should be created for the Windows Server 2016 image. By default, this value is set to true.|
|location||No||Specifies the location to which the Windows Server 2016 image should be published. By default, this value is set to local.|
|CUUri||No||Set this value to choose the Windows Server 2016 cumulative update from a specific URI.|
|CUPath||No||Set this value to choose the Windows Server 2016 cumulative update from a local path. This option is helpful if you have deployed Azure Stack in a disconnected environment.|