Add Location to Add-AzureStackVMSSGalleryitem (#204)

Author: knithinc

ComputeAdmin/AzureStack.ComputeAdmin.psm1

@@ -3,15 +3,36 @@
 
 #requires -Modules AzureStack.Connect
 
+<#
+    .SYNOPSIS
+    Add-AzureStackVMSSGalleryItem: Adds the VMSS Gallery Item to your Azure Stack Marketplace.
+    Remove-AzureStackVMSSGalleryItem: Adds the VMSS Gallery Item from your Azure Stack Marketplace.
+    Add-VMImage: Uploads a VM Image to your Azure Stack and creates a Marketplace item for it.
+    Remove-VMImage: Removes an existing VM Image from your Azure Stack.  Does not delete any 
+    maketplace items created by Add-VMImage.
+    New-Server2016VMImage: Creates and Uploads a new Server 2016 Core and / or Full Image and
+    creates a Marketplace item for it.
+    Get-VMImage: Gets a VM Image from your Azure Stack as an Administrator to view the provisioning state of the image.
+    Add-VMExtension: Uploads a VM extension to your Azure Stack.
+    Remove-VMExtension: Removes an existing VM extension from your Azure Stack.
+#>
+
 function Add-AzureStackVMSSGalleryItem {
+    [CmdletBinding()]
+    Param(
+        [Parameter(Mandatory=$false)]
+        [ValidatePattern("^[0-9a-zA-Z]+$")]
+        [ValidateLength(1,128)]
+        [String] $Location = 'local'
+    )
 
     $rgName = "vmss.gallery"
 
-    New-AzureRmResourceGroup -Name $rgName -Location local -Force
+    New-AzureRmResourceGroup -Name $rgName -Location $Location -Force
 
     $saName = "vmssgallery"
 
-    $sa = New-AzureRmStorageAccount -ResourceGroupName $rgName -Location local -Name $saName -Type Standard_LRS
+    $sa = New-AzureRmStorageAccount -ResourceGroupName $rgName -Location $Location -Name $saName -Type Standard_LRS
 
     $cName = "gallery"
 
@@ -41,19 +62,6 @@ function Remove-AzureStackVMSSGalleryItem {
     }
 }
 
-<#
-    .SYNOPSIS
-    Contains 6 functions.
-    Add-VMImage: Uploads a VM Image to your Azure Stack and creates a Marketplace item for it.
-    Remove-VMImage: Removes an existing VM Image from your Azure Stack.  Does not delete any 
-    maketplace items created by Add-VMImage.
-    New-Server2016VMImage: Creates and Uploads a new Server 2016 Core and / or Full Image and
-    creates a Marketplace item for it.
-    Get-VMImage: Gets a VM Image from your Azure Stack as an Administrator to view the provisioning state of the image.
-    Add-VMExtension: Uploads a VM extension to your Azure Stack.
-    Remove-VMExtension: Removes an existing VM extension from your Azure Stack.
-#>
-
 Function Add-VMImage{
 
     [CmdletBinding(DefaultParameterSetName='VMImageFromLocal')]

ComputeAdmin/README.md

@@ -140,20 +140,21 @@ VM Scale Set allows deployment of multi-VM collections. To add a gallery item wi
 3. Add VM Scale Set gallery item as follows
 
 ```powershell
-$Tenant = "<AAD Tenant Id used to connect to AzureStack>"
+$TenantId = "<AAD Tenant Id used to connect to AzureStack>"
 $Arm = "<AzureStack administrative Azure Resource Manager endpoint URL>"
+$Location = "<The location name of your AzureStack Environment>"
 
 Add-AzureStackAzureRmEnvironment -Name AzureStackAdmin -ArmEndpoint $Arm 
 
 $Password = ConvertTo-SecureString -AsPlainText -Force "<your AzureStack admin user password>"
 $User = "<your AzureStack admin user name>"
 $Creds =  New-Object System.Management.Automation.PSCredential $User, $Password
 
-Login-AzureRmAccount -EnvironmentName AzureStackAdmin -Credential $Creds -TenantId $Tenant
+Login-AzureRmAccount -EnvironmentName AzureStackAdmin -Credential $Creds -TenantId $TenantId
 
 Select-AzureRmSubscription -SubscriptionName "Default Provider Subscription"
 
-Add-AzureStackVMSSGalleryItem
+Add-AzureStackVMSSGalleryItem -Location $Location
 ```
 To remove VM Scale Set gallery item run the following command: