Connect Operator Connect - Document Details

This page contains Windows bias

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

powershell_heavy

missing_linux_example

windows_tools

windows_first

Summary

The documentation is heavily biased toward Windows environments, specifically PowerShell. All command-line instructions are provided exclusively for PowerShell, with no mention of Linux or cross-platform alternatives such as Azure CLI, Bash, or Cloud Shell. The steps assume the user is running PowerShell on Windows, including instructions to 'open PowerShell as admin,' and do not provide equivalent guidance for Linux or macOS users. Windows tools and patterns are referenced throughout, and there are no Linux-specific notes or parity examples.

Recommendations

Provide equivalent Azure CLI or Bash commands for all PowerShell instructions, especially for module installation and authentication steps.
Explicitly mention cross-platform options such as Azure Cloud Shell, which supports both PowerShell and Bash and works on any OS.
Add notes or sections for Linux/macOS users, clarifying any differences in command syntax, prerequisites, or permissions.
Avoid instructions that are Windows-specific (e.g., 'open PowerShell as admin') without offering alternatives for non-Windows systems.
Where PowerShell modules are required, clarify their cross-platform compatibility or provide alternatives if available.
Consider reordering examples or providing parallel instructions so that Linux/macOS users are not an afterthought.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Clean
2025-07-09 13:09	#3	cancelled	Clean
2025-07-08 04:23	#2	cancelled	Biased

Flagged Code Snippets

       Get-Module -ListAvailable

            Install-Module Microsoft.Entra

    Connect-Entra -TenantId <TenantID> -Scopes 'Application.ReadWrite.All'
    New-EntraServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"

    $acgName = "<CommunicationsGatewayName>"

    Disconnect-MgGraph

       Get-Module -ListAvailable

            Install-Module -Name Microsoft.Graph -Scope CurrentUser

    Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"

    # Get the Service Principal ID for Project Synergy (Operator Connect)
    $projectSynergyApplicationId = "eb63d611-525e-4a31-abd7-0cb33f679599"
    $projectSynergyEnterpriseApplication = Get-MgServicePrincipal -Filter "AppId eq '$projectSynergyApplicationId'" # "Application.Read.All"
    
    # Required Operator Connect - Project Synergy Roles
    $trunkManagementRead = "72129ccd-8886-42db-a63c-2647b61635c1"
    $trunkManagementWrite = "e907ba07-8ad0-40be-8d72-c18a0b3c156b"
    $partnerSettingsRead = "d6b0de4a-aab5-4261-be1b-0e1800746fb2"
    $numberManagementRead = "130ecbe2-d1e6-4bbd-9a8d-9a7a909b876e"
    $numberManagementWrite = "752b4e79-4b85-4e33-a6ef-5949f0d7d553"
    $dataRead = "eb63d611-525e-4a31-abd7-0cb33f679599"
    $dataWrite = "98d32f93-eaa7-4657-b443-090c23e69f27"
    $requiredRoles = $trunkManagementRead, $trunkManagementWrite, $partnerSettingsRead, $numberManagementRead, $numberManagementWrite, $dataRead, $dataWrite

    # Locate the Azure Communications Gateway resource by name
    $acgServicePrincipal = Get-MgServicePrincipal -Filter ("displayName eq '$acgName'")

    # Assign the required roles to the managed identity of the Azure Communications Gateway resource
    $currentAssignments = Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
    foreach ($appRoleId in $requiredRoles) {
        $assigned = $currentAssignments | Where-Object { $_.AppRoleId -eq $AppRoleId }
        if (-not $assigned) {
            $params = @{
                principalId = $acgServicePrincipal.Id
                resourceId = $projectSynergyEnterpriseApplication.Id
                appRoleId = $appRoleId
            }
            New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id -BodyParameter $params
        }
    }

    # Check the assigned roles
    Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id