Quick tip for all potential Azure Stack Cloud Operators
As you’d be aware, essentially the majority of the Azure Stack extended setup requires PowerShell. Not only does managing Azure Stack require PowerShell, it requires specific modules, tools and PowerShell profiles…
Oh, did I mention Azure Stack management requires PowerShell?
This is typically fine, but if you’re anything like me and tend to use your computer (desktop/laptop etc) for many different functions, managing PowerShell profiles and having them all aligned can be a bit of a pain.
I handle this by creating myself a dedicated Cloud Operator VM. This way no matter what I am doing, I’ll always be able to connect and manage my Azure Stack without any annoying issues.
In my environment, I have an external Hyper-V cluster which can access the Azure Stack endpoints. The decision was to deploy a Windows Server 2016 VM here and install the required management ‘bits’. This is also where I build/modify any scripts using Visual Studio Code… (This was a recent switch for me from ISE. I’m still coming to terms with it 🙂 )
List of steps and tools to install:
- Deploy/Identify your Cloud Operator VM
- Configure WinRM for ERCS
- Install Azure Stack PowerShell modules
- Install Azure Stack Tools
- Verify connection to ARM Admin
- Verify connection to privileged endpoint
- Install Visual Studio Code
All Azure Stack sources for the required tasks:
Install PowerShell for Azure Stack
https://docs.microsoft.com/en-us/azure/azure-stack/azure-stack-powershell-install
Download Azure Stack tools from GitHub
https://docs.microsoft.com/en-us/azure/azure-stack/azure-stack-powershell-download
Connect to Azure Stack with PowerShell as an operator
https://docs.microsoft.com/en-us/azure/azure-stack/azure-stack-powershell-configure-admin
Download and install Visual Studio Code
https://code.visualstudio.com/download
Ok, let’s get cracking!
1. Deploy/Identify your Cloud Operator VM.
I called mine CloudOperator… Yes, very creative I know 
Not that it’s required, but I went with 8 vCPU and 4GB of memory. I will likely drop the vCPU to 4 at some point but from my old PDT days having more threads mean things wen faster… Not so much with single PS scripts but I have plenty of spare processing so why not.
Up date your VM to the latest CU. 1810 was the most up to date at the time.
2. Configure WinRM for ERCS
Add the ERCS IP’s as WinRM trusted hosts. If you do not do this you will likely have difficulties connecting to the ERCS endpoints with ambiguous access denied errors.
winrm s winrm/config/client ‘@{TrustedHosts=”10.61.11.224,10.61.11.225,10.61.11.226″}’
*adjust the IP addresses to suit your environment
3. Install Azure Stack PowerShell modules
The below is taken verbatim from docs. Have I mentioned how good they are these days at updating docs??
Uninstall-Module -Name AzureRM.AzureStackAdmin -Force Uninstall-Module -Name AzureRM.AzureStackStorage -Force Uninstall-Module -Name AzureStack -Force Get-Module -Name Azs.* -ListAvailable | Uninstall-Module -Force # Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet Install-Module -Name AzureRm.BootStrapper # Install and import the API Version Profile required by Azure Stack into the current PowerShell session. Use-AzureRmProfile -Profile 2018-03-01-hybrid -Force Install-Module -Name AzureStack -RequiredVersion 1.5.0
*note: at the time of writing, I had to revert to a previous PowerShell profile and AzureStack module to install the SQL and MySQL resource providers (which were literally updated as I am writing this). Whist this is fairly easy to do, I save the different scripts to uninstall and install the appropriate profiles so they are on demand
Get-Module -Name "Azure*" -ListAvailable Get-Module -Name "Azs*" -ListAvailable
4. Install Azure Stack Tools
# Change directory to the root directory. cd \ # Download the tools archive. [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 invoke-webrequest ` https://github.com/Azure/AzureStack-Tools/archive/master.zip ` -OutFile master.zip # Expand the downloaded files. expand-archive master.zip ` -DestinationPath . ` -Force # Change to the tools directory. cd AzureStack-Tools-master
5. Connect to Azure Stack
# For Azure Stack development kit, this value is set to https://adminmanagement.local.azurestack.external. # To get this value for Azure Stack integrated systems, contact your service provider. $adminARMEndpoint = "https://adminmanagement.region.domain.com" # Register an AzureRM environment that targets your Azure Stack instance Add-AzureRMEnvironment -Name "AzureStackAdmin" -ArmEndpoint $adminARMEndpoint # After signing in to your environment, Azure Stack cmdlets # can be easily targeted at your Azure Stack instance. Add-AzureRmAccount -EnvironmentName "AzureStackAdmin"
Run Get-AzureRMResourceGroup and Get-AzureRMSubscription to demostrate you’re connected to Azure Stack
6. Connect to Azure Stack privileged endpoint
$CloudAdminCreds = Get-Credential
Enter the credentials used for the deployment (you know these right?)
Enter-PSSession -ComputerName $privilegedEndpoint ` -ConfigurationName PrivilegedEndpoint -Credential $CloudAdminCreds
Run a get-command to see all you are allowed to do
Anything outside of this will fail… And I mean ANYTHING! …even a ping.
Enter Get-AzureStackStampInformation
[10.61.11.224]: PS> get-azurestackstampinformation WARNING: The names of some imported commands from the module 'ECEClient' include unapproved verbs that might make them less discoverable. To find the commands with unapproved verbs, run the Import-Module command again with the Verbose parameter. For a list of approved verbs, type Get-Verb. DeploymentID : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx OemVersion : 1.0.1805.1 PackageHash : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx StampVersion : 1.1809.3.96 InitialDeployedVersion : 1.1808.0.97 Prefix : AzS CompanyName : domain.com ServerSku : Core Topology : HyperConverged <…> TenantExternalEndpoints : @{TenantResourceManager=https://management.region.domain.com/; TenantResourceManagerCertificateMetadata=https://management.region.domain.com:30024/; TenantPortal=https://portal.region.domain.com/; TenantHosting=https://*.hosting.region.domain.com/} AdminExternalEndpoints : @{AdminResourceManager=https://adminmanagement.region.domain.com/; AdminResourceManagerCertificateMetadata=https://adminmanagement.region.domain.com:30024/; AdminPortal=https://adminportal.region.domain.com/; AdminFrontdoor=https://adminmanagement.region.domain.com/; AdminShellSite=https://adminportal.region.domain.com/; AdminGallery=https://adminportal.region.domain.com:30015/; AdminHosting=https://*.adminhosting.region.domain.com/} IdentitySystem : AzureAD ExternalDomainFQDN : region.domain.com ERCS VMs : {@{Name=AzS-ERCS01; HostName=AzS-Node04; IPAddress=10.61.11.224}, @{Name=AzS-ERCS02; HostName=AzS-Node03; IPAddress=10.61.11.225}, @{Name=AzS-ERCS03; HostName=AzS-Node01; IPAddress=10.61.11.226}} AD VMs : {@{Name=AzS-DC01; HostName=AzS-Node02}, @{Name=AzS-DC02; HostName=AzS-Node03}} [10.61.11.224]: PS> exit
Save this info somewhere safe!
Remember to exit the remote session
Happy Cloud Operating 
Dan
