2 Create Package - 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

windows_first

windows_tools

missing_linux_example

Summary

The documentation is heavily PowerShell-centric, with all command-line examples and tooling instructions provided in PowerShell syntax. Windows-specific paths and outputs are shown by default, and the workflow assumes use of Windows tools (e.g., Expand-Archive, Get-ChildItem) even when discussing Linux configurations. While Linux is mentioned, Linux-specific command-line examples and equivalent native tooling are missing, and Windows examples are consistently presented first or exclusively.

Recommendations

Provide Linux-native command-line examples (e.g., using bash, unzip, ls, du) alongside or in place of PowerShell commands when discussing Linux configurations.
Show Linux file paths and outputs (e.g., /home/user/dsc/MyConfig) in relevant examples, not just Windows paths.
When introducing tools or commands, present Linux equivalents either first or in parallel with Windows (e.g., 'On Windows, use Expand-Archive; on Linux, use unzip').
Include a full Linux workflow for authoring, compiling, and packaging configurations, not just a Windows-centric one.
Clarify any platform-specific requirements or differences in the main flow, not just in notes.
Ensure that all steps (such as renaming files, checking package size, etc.) have Linux-native command alternatives.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

Install-Module -Name PSDscResources
Import-Module -Name PSDscResources
Configuration MyConfig {
    Import-DscResource -Name 'Environment' -ModuleName 'PSDscResources'
    Environment MachineConfigurationExample {
        Name   = 'MC_ENV_EXAMPLE'
        Value  = 'This was set by machine configuration'
        Ensure = 'Present'
        Target = @('Process', 'Machine')
    }
}

MyConfig

Install-Module -Name nxtools
Import-Module -Name nxtools
Configuration MyConfig {
    Import-DscResource -ModuleName 'nxtools'
    nxFile MyFile {
        Ensure = 'Present'
        DestinationPath = '/tmp/myfile'
        Contents = 'Hello, world!'
        Mode ='0777'
    }
}

MyConfig

& .\MyConfig.ps1

    Directory: C:\dsc\MyConfig

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           5/16/2023 10:39 AM           1080 localhost.mof

Name     Path
----     ----
MyConfig C:\dsc\MyConfig.zip

    Directory: C:\dsc\MyConfig

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           5/16/2023 10:40 AM           1080 MyConfig.mof

# Create a package that will only audit compliance
$params = @{
    Name          = 'MyConfig'
    Configuration = './MyConfig/MyConfig.mof'
    Type          = 'Audit'
    Force         = $true
}
New-GuestConfigurationPackage @params

# Create a package that will audit and apply the configuration (Set)
$params = @{
    Name          = 'MyConfig'
    Configuration = './MyConfig/MyConfig.mof'
    Type          = 'AuditAndSet'
    Force         = $true
}
New-GuestConfigurationPackage @params

Expand-Archive -Path .\MyConfig.zip -DestinationPath MyConfigZip

Get-ChildItem -Recurse -Path .\MyConfigZip |
    Measure-Object -Sum Length |
    ForEach-Object -Process {
        $Size = [math]::Round(($_.Sum / 1MB), 2)
        "$Size MB"
    }