Deploy Sdk - 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

powershell_heavy

windows_tools

missing_linux_example

windows_first

Summary

The documentation page demonstrates a Windows bias in several ways: all command-line examples for key vault and certificate management use PowerShell, with no Bash, Azure CLI, or Linux-native alternatives. The SDK code samples and extension configuration reference Windows-centric patterns (e.g., RDP, Microsoft.Windows.Azure.Extensions). Windows tools and terminology (PowerShell, RDP, .cspkg) are mentioned exclusively or before Linux equivalents, and there is no guidance for Linux users on how to perform these steps. The absence of Linux or cross-platform command-line examples and the prioritization of Windows-centric workflows indicate a significant bias toward Windows environments.

Recommendations

Add equivalent Azure CLI and Bash examples for all PowerShell commands, especially for key vault and certificate management.
Explicitly mention Linux support and provide instructions for Linux users, including how to install required SDKs and tools.
Include references to Linux-friendly remote access extensions (such as SSH) alongside RDP, and clarify cross-platform options.
Document how to generate and upload certificates from Linux environments (e.g., using OpenSSL and Azure CLI).
Review terminology and tool references to ensure parity (e.g., mention both .cspkg and .zip formats, clarify their use on Linux).
Add a section or callout for cross-platform deployment considerations, highlighting any differences or requirements for Linux users.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-12 00:00	#99	completed	Clean
2026-01-11 06:20	#98	completed	Biased
2026-01-10 00:00	#92	completed	Clean
2026-01-06 22:28	#78	completed	Clean
2025-12-29 18:00	#48	cancelled	Biased
2025-12-15 00:00	#7	completed	Clean
2025-12-14 05:05	#6	completed	Clean

Flagged Code Snippets

   Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosoOrg' -UserPrincipalName 'user@domain.com' -PermissionsToCertificates create,get,list,delete

   New-AzKeyVault -Name "ContosKeyVault” -ResourceGroupName “ContosoOrg” -Location “East US”

    Set-AzKeyVaultAccessPolicy -VaultName 'ContosKeyVault' -ResourceGroupName 'ContosOrg' -ObjectId 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' -PermissionsToCertificates create,get,list,delete

    $Policy = New-AzKeyVaultCertificatePolicy -SecretContentType "application/x-pkcs12" - SubjectName "CN=contoso.com" -IssuerName "Self" -ValidityInMonths 6 -ReuseKeyOnRenewal 
    Add-AzKeyVaultCertificate -VaultName "ContosKeyVault" -Name "ContosCert" -CertificatePolicy $Policy

    string rdpExtensionPublicConfig = "<PublicConfig>" +
        "<UserName>adminRdpTest</UserName>" +
        "<Expiration>2021-10-27T23:59:59</Expiration>" +
        "</PublicConfig>";
        string rdpExtensionPrivateConfig = "<PrivateConfig>" +
        "<Password>VsmrdpTest!</Password>" +
        "</PrivateConfig>";
    
        Extension rdpExtension = new Extension
                {
                    Name = name,
                    Properties = new CloudServiceExtensionProperties
                    {
                        Publisher = "Microsoft.Windows.Azure.Extensions",
                        Type = "RDP",
                        TypeHandlerVersion = "1.2.1",
                        AutoUpgradeMinorVersion = true,
                        Settings = rdpExtensionPublicConfig,
                        ProtectedSettings = rdpExtensionPrivateConfig,
                        RolesAppliedTo = [“*”],
                    }
                };
                        
    CloudServiceExtensionProfile cloudServiceExtensionProfile = new CloudServiceExtensionProfile
        {
            Extensions = rdpExtension
        };