PowerShell通用仪表板：您的Azure指南 – techsyncer

如果你知道如何编写 PowerShell 并且需要构建一个图形仪表板来表示几乎任何数据，请查看PowerShell Universal Dashboard（UD）。UD是一种直观的方式，只需使用 PowerShell 就可以构建漂亮的仪表板甚至表单。幸运的是，Universal PowerShell Dashboard 可以在 Azure 中运行！

Universal PowerShell Dashboard 是一个 PowerShell 模块，可以通过运行Install-Module -Name UniversalDashboard.Community来安装。社区模块是免费的，但我鼓励你购买完整版本。

I’m not going to go into the ins and outs of UD, Adam Driscoll (UD’s developer) has written extensive documentation already on the topic.

UD 需要一个 Web 服务器来运行。你可以选择在IIS上运行 UD，也可以在 Azure Web App 中运行。我讨厌搞定地方基础设施，所以我总是选择在可能的情况下将资源部署到云中。由于 UD 本地支持在 Azure Web App 中运行，它是完美的云候选者。

I found that even though UD has docs for setting it up in Azure, I still was struggling with an easy way to get it going. I managed to come up with a rough PowerShell script to setup the latest instance for you all in one swoop.

它可能需要一些改进，但我只是需要它用于即将进行的Pluralsight课程。随时根据需要进行改进。希望里面的注释足够清楚地解释了一切。

param(
	[Parameter(Mandatory)]
	[ValidateNotNullOrEmpty()]
	[string]$WebAppName,
	
	[Parameter(Mandatory)]
	[ValidateNotNullOrEmpty()]
	[string]$AzureLocation,

	[Parameter(Mandatory)]
	[ValidateNotNullOrEmpty()]
	[string]$AzureResourceGroup
)

#region 创建 Azure Web 应用
$appSrvPlan = New-AzAppServicePlan -Name "$WebAppName-AppSrv" -Location $AzureLocation -ResourceGroupName $AzureResourceGroup -Tier Free
$null = New-AzWebApp -Name $WebAppName -AppServicePlan $appSrvPlan.Name -ResourceGroupName $AzureResourceGroup -Location $AzureLocation
#endregion

#region 下载 UD
Save-Module UniversalDashboard.Community -Path $env:TEMP -AcceptLicense
$udModulePath = (Get-ChildItem -Path "$env:TEMP\UniversalDashboard.Community" -Directory).FullName
#endregion

# 获取 Web 应用的发布配置文件
$pubProfile = Get-AzWebAppPublishingProfile -Name $Webappname -ResourceGroupName $AzureResourceGroup
$ftpPubProfile = ([xml]$pubProfile).publishData.publishProfile | Where-Object { $_.publishMethod -eq 'FTP' }

## 构建用于身份验证的凭据
$password = ConvertTo-SecureString $ftpPubProfile.userPWD -AsPlainText -Force
$azureCred = New-Object System.Management.Automation.PSCredential ($ftpPubProfile.userName, $password)

try {
	$webclient = New-Object -TypeName System.Net.WebClient
	$webclient.Credentials = $azureCred

	#region 创建所有文件夹
	Get-ChildItem -Path $udModulePath -Directory -Recurse | foreach {
		$path = $_.FullName.Replace("$udModulePath\", '').Replace('\', '/')
		$uri = "$($ftpPubProfile.publishUrl)/$path"
		$makeDirectory = [System.Net.WebRequest]::Create($uri)
		$makeDirectory.Credentials = $azureCred
		$makeDirectory.Method = [System.Net.WebRequestMethods+FTP]::MakeDirectory
		Write-Host "Creating folder [$path]..."
		$null = $makeDirectory.GetResponse()
	}
	#endregion

	## 创建一个简单的仪表板以启动网站
	Set-Content -Path "$udModulePath\dashboard.ps1" -Value 'Start-UDDashboard -Wait'

	#region 上传所有文件
	Get-ChildItem -Path $udModulePath -File -Recurse | foreach {
		$path = $_.FullName.Replace("$udModulePath\", '').Replace('\', '/').Replace('.\', '')
		$uri = New-Object System.Uri("$($ftpPubProfile.publishUrl)/$path")
		Write-Host "Uploading file [$path]..."
		$null = $webclient.UploadFile($uri, $_.FullName)
	}
	#endregion
} catch {
	$PSCmdlet.ThrowTerminatingError($_)
} finally {
	## 清理
	$webclient.Dispose()
}

I called the script New-UDAzureInstance.ps1 and launch it like:

PS> ./New-UDAzureInstance.ps1 -WebAppName ADBPoshUD -AzureResourceGroup 'Course-PowerShellDevOpsPlaybook' -AzureLocation 'East US'

在 Azure 中设置好 UD 后，您将修改 dashboard.ps1 文件以构建您需要的任何类型的仪表板。

浏览到 Azure Web 应用的 URL，沐浴在新安装的 Universal PowerShell 仪表板实例的荣耀中。

I hope this saves some people some time setting up Universal Powershell Dashboard in Azure!