Repository navigation
Azure.Admin.Console 0.14.6-preview1
Pre-release
Pre-release
·
18 commits
to main
since this release
Governance across the tenant in the spirit of the Azure Governance Visualizer - eleven new commands and one workbook - Service Bus and Cosmos DB assessments, editable draw.io diagrams of what you have, existing resources exported as Terraform, and a dashboard that now covers security, policy, governance, cost and what to do next. Published as a pre-release (0.14.6-preview1) first.
New
- Service Bus assessment.
Invoke-AACServiceBusAssessment: every namespace's requests, errors and throttling, Premium CPU and memory, and every queue, topic and subscription's messages as they are now - active, dead-lettered, transfer dead-lettered, scheduled, how full it is, when it was last used; findings under health, capacity, messages, security, resilience and cost (dead letters, entities filling up, backlogs, topics with no subscription, SAS keys, open networks, no logs, no zones or Geo-DR, idle entities, too many messaging units), a heat map, and-View Namespace|Entity|Finding. - Cosmos DB assessment.
Invoke-AACCosmosDBAssessment, for every API (NoSQL, MongoDB, Cassandra, Gremlin, Table): availability, requests by status and rate limiting (429), request units and the busiest partition, latency, storage, every database and container with its throughput (autoscale, manual, shared, serverless); findings under availability, throttling, errors, security, resilience and cost (single region, no failover, periodic backup, open networks, account keys, over-provisioned throughput, many small containers with their own throughput), a heat map, and-View Account|Container|Finding. - Terraform export.
Export-AACTerraformexports existing resources as Terraform through the Azure Export for Terraform API (2026-09-01-preview):- a resource group (several in one subscription exported together, with their child resources), resource IDs - or anything piped with an
IdorResourceId- or a Resource Graph where-clause; a folder per subscription; - the export is a long-running operation: submitted, polled as Azure asks (
Retry-After), with Azure's reason when it fails; each export shows its status, how long it has run and how many batches are done (Azure gives no percentage); - large exports: the resources are counted first (Resource Graph), with advice when an export is large;
-BatchSizesplits it into exports that run at the same time (-ThrottleLimit) and merges them into one folder - a resource two batches return is kept once, and references to it follow; several subscriptions are exported at the same time; -Resume: the operations are saved inexport.jsonas soon as Azure accepts them, so an export still running after Ctrl+C or-TimeoutMinutesis collected later without exporting again;- a folder ready for
terraform initandplan:terraform.tf,providers.tf(with the subscription ID),main.tf,import.tf(import blocks - noterraform importto run) andexport.json; - what couldn't be exported is listed, never dropped;
-FallbackToAzApiexports what azurerm can't again with the azapi provider, merged into one module (azapi.tf); -Planrunsterraform init,validateandplanand reads the plan asGet-AACTerraformPlandoes: a faithful export plans only imports, anything else is listed;- sensitive values masked unless
-IncludeSensitive; existing Terraform files not overwritten without-Force;-RegisterProviderregistersMicrosoft.AzureTerraformwhere it isn't (asks first, honours-WhatIf).
- a resource group (several in one subscription exported together, with their child resources), resource IDs - or anything piped with an
- Editable diagrams.
Export-AACDiagramdraws your existing resources as a draw.io diagram you can edit - not a picture:- four views:
Resources(resource groups or subscriptions, with network links, peerings, private endpoints, routes, DNS links and dependencies),Network(hubs and spokes, gateways, firewalls),ApplicationGateway(each gateway's flow) andGovernance(the management group hierarchy); - boxes are draw.io containers; resources carry the Azure icons, their data and a portal link; connections stay attached when you move things;
-Updaterefreshes the diagram from Azure and keeps your edits: new resources are added and marked, removed ones faded (-Prunedeletes them);-SplitByputs each subscription, resource group, management group, region or gateway on its own page; a Legend page explains the boxes and lines;-HtmlPathand-PdfPathwrite a clean copy with a legend: an interactive page, and a one-page vector PDF drawn by Microsoft Edge or Google Chrome.
- four views:
- Governance, each question a command of its own:
Invoke-AACGovernanceAssessment: the hierarchy, access, identities, policy remediation, limits, settings, tags, locks and changes in one tabbed workbook, with the high and medium findings of every area;-MarkdownPathwrites it as a wiki page (GitHub or Azure DevOps) with the hierarchy as a Mermaid diagram.Show-AACManagementGroupMap: the management group hierarchy as an interactive map and a console tree, with the subscriptions, policy and role assignments at each level.Get-AACRoleAssignment: every role assignment at every scope - user, guest, group, application or another tenant's, system- or user-assigned identity, deleted - what the role can do, how far it reaches, standing or PIM, group members (-ExpandGroup), who created it; orphaned assignments, privileged guests, applications as Owner and custom roles unused or equivalent to Owner flagged.Get-AACServicePrincipalInsight: applications and managed identities with Azure roles, their credentials about to expire, other tenants' applications, user-assigned identities attached to nothing or shared too widely.Test-AACAzureLimit: scopes close to an Azure limit - role assignments, custom roles, policy assignments, definitions, initiatives and exemptions, resource groups, tags, management group depth - with what to do;-Maximumfor a raised limit,-FailOnLimitfor a pipeline gate.Get-AACGovernanceSetting: who can create management groups, where new subscriptions land, management group activity logs, Defender security contacts, classic administrators, preview features, resource providers registered unevenly, each subscription's offer and state.Get-AACPolicyRemediation: DeployIfNotExists and Modify policies with resources they could fix, and what their remediation tasks did - never run, failed, drifted again, or no identity to run with.Get-AACTagUsage: tag coverage and consistency - names that clash in casing, near-duplicates, values in mixed casing, how far-RequiredTagreaches.Get-AACResourceLock: every lock, the critical resources no lock protects, and ReadOnly locks that break more than they protect.Get-AACGovernanceChange: policy and access created or updated in the last days, with the author resolved and privileged grants flagged.Test-AACAlzPolicy: your management groups' policy assignments against the Azure Landing Zones archetypes (a local copy of the ALZ Library) - missing, different or present, and the library file to deploy from.
Changed
Show-AACDashboard- the second edition, from the same single Resource Graph batch (24 queries instead of 8):- an Estate score (0-100) from availability, secure score, policy compliance and the Advisor score, and a second row of score tiles;
- Security (secure score, alerts and recommendations by severity, Defender plans), Governance (policy compliance, the closest role assignment limit, privileged role assignments, unused disks, public IPs and NICs, tag coverage), Advisor savings, resources by type and subscription, the last 14 days of changes and who made them;
-IncludeCost: month to date against the same days last month, a forecast, 30 days and what costs most (Cost Management);- What to do next: the actions that matter most, ranked across every section, each with the command that goes deeper (
.Actionsreturns them); -Sectionshows only some sections;-HtmlPath,-PdfPathand-CsvPathwrite it as a report with a tab per section;-Watchrefreshes it for a screen on the wall.- Every property of
AAC.Dashboardis still there; the status also turns to Needs attention for high-severity security alerts, policy compliance below 80%, a subscription at 80% of the role assignment limit, or spend more than 10% above last month.
- The browser maps (
Show-AACResourceMap,Show-AACNetworkTopology,Show-AACApplicationGatewayMap): a draw.io button saves the map as an editable diagram exactly as laid out; the legend now explains the boxes too (subscription, resource group, virtual network, hub, subnet, Application Gateway) and the resource flags; "Open in the Azure portal" sits at the top of a resource's details. Show-AACResourceMap,Show-AACNetworkTopologyandShow-AACApplicationGatewayMapread Azure through shared readers, the same ones the diagrams use (no change to what they show).Invoke-AACArmWrite(the module's write helper) runs POST actions too and returns their result; the newInvoke-AACArmOperationBatchruns several long-running operations side by side.Get-AACServicePrincipalInsightasks Microsoft Graph for the app registrations in a fixed order, so the same principals always make the same requests.- The tests run on Pester 6.2+ (below 7) instead of Pester 5:
build.ps1, CI and the release workflow install and require it, andbuild.ps1 -Task Testsays what to install when it's missing. Pester 6 needs PowerShell 7.4 or later to run the tests; the module itself still runs on 7.2. The test files needed no change. - CI and the release workflow install their modules through
tools/Install-BuildModule.ps1, which tries again (up to four times, waiting longer each time) when the PowerShell Gallery answers 5xx - a 504 from the Gallery had failed a release. - The release workflow publishes pre-releases: a
Prereleasevalue in the manifest (0.14.6-preview1) is taggedv0.14.6-preview1and published as a pre-release;tools/Step-ModuleVersion.ps1 -Prereleasesets or clears it.
Fixed
- Three test files (
GovernanceAssessment,PolicyRemediation,PSRule) failed on GitHub Actions only: Spectre.Console's default enrichers detect CI and turn colours back on, so the captured console text held colour codes. Their captures now turn the enrichers off, as the others do. Get-AACTerraformPlancounted a pure import (or move) twice in its totals: once as its action, and again as an import (or move).
A pre-release. Install: Install-PSResource -Name Azure.Admin.Console -Version 0.14.6-preview1 -Prerelease