Publish Service Catalog App - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_first

powershell_heavy

windows_tools

Summary

The documentation presents Azure PowerShell (which is Windows-centric) examples before Azure CLI in each code section, and consistently refers to Visual Studio Code as the editor, which is more commonly associated with Windows workflows. The PowerShell examples use Windows-specific concepts like splatting, and the instructions for opening a terminal default to PowerShell first, with Bash (and Git Bash) as a secondary note. There are no explicit Linux-only examples or Linux-specific tooling mentioned, and the documentation does not address platform-specific nuances for Linux users.

Recommendations

Alternate the order of PowerShell and Azure CLI sections, or present Azure CLI first, as it is cross-platform and more commonly used on Linux.
Explicitly mention that Visual Studio Code and all tools are available on Linux, and provide links or notes for Linux installation where relevant.
Instruct users to open a Bash terminal (or their preferred shell) first, not just PowerShell, and clarify that all steps work on Linux/macOS as well as Windows.
Add troubleshooting notes or tips for Linux users where file paths, permissions, or shell behavior may differ.
Where PowerShell-specific features (like splatting) are used, briefly explain or provide equivalent Bash/CLI idioms.
Consider including at least one example using native Linux tools (e.g., zip/unzip commands, or using the Azure CLI from a Linux shell) to demonstrate parity.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-12 00:00	#243	cancelled	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Biased

Flagged Code Snippets

Connect-AzAccount

New-AzResourceGroup -Name packageStorageGroup -Location westus

$pkgstorageparms = @{
  ResourceGroupName = "packageStorageGroup"
  Name = "<pkgstorageaccountname>"
  Location = "westus"
  SkuName = "Standard_LRS"
  Kind = "StorageV2"
  MinimumTlsVersion = "TLS1_2"
  AllowBlobPublicAccess = $true
  AllowSharedKeyAccess = $false
}

$pkgstorageaccount = New-AzStorageAccount @pkgstorageparms

Remove-AzResourceGroup -Name packageStorageGroup

Remove-AzResourceGroup -Name appDefinitionGroup

$pkgstoragecontext = New-AzStorageContext -StorageAccountName $pkgstorageaccount.StorageAccountName -UseConnectedAccount

New-AzStorageContainer -Name appcontainer -Context $pkgstoragecontext -Permission blob

$blobparms = @{
  File = "app.zip"
  Container = "appcontainer"
  Blob = "app.zip"
  Context = $pkgstoragecontext
}

Set-AzStorageBlobContent @blobparms

$blob = Get-AzStorageBlob -Container appcontainer -Blob app.zip -Context $pkgstoragecontext

$publishparms = @{
  Name = "sampleManagedApplication"
  Location = "westus"
  ResourceGroupName = "appDefinitionGroup"
  LockLevel = "ReadOnly"
  DisplayName = "Sample managed application"
  Description = "Sample managed application that deploys web resources"
  Authorization = "${principalid}:$roleid"
  PackageFileUri = $blob.ICloudBlob.StorageUri.PrimaryUri.AbsoluteUri
}

New-AzManagedApplicationDefinition @publishparms