Codecov Report

❌ Patch coverage is 94.24658% with 21 lines in your changes missing coverage. Please review.
✅ Project coverage is 94%. Comparing base (8313dbe) to head (cf61df7).
⚠️ Report is 1 commits behind head on main.

@@          Coverage Diff          @@
##           main   #2154    +/-   ##
=====================================
  Coverage    94%     94%            
=====================================
  Files       132     145    +13     
  Lines      8740    9091   +351     
=====================================
+ Hits       8284    8617   +333     
- Misses      456     474    +18     

@copilot We should also add commands Enable-SqlDscAgentOperator and Disable-SqlDscAgentOperator that sets the Enabled propert on the Operator object.

Added both Enable-SqlDscAgentOperator and Disable-SqlDscAgentOperator commands that set the Enabled property on the Operator object. Both commands follow the same pattern as the existing Enable/Disable login commands with ServerObject and OperatorObject parameter sets, ShouldProcess support, Force parameter, and Refresh option. Commit e8c3673

Walkthrough

Adds a comprehensive Agent Operator command suite and configuration option commands, new private helpers and SMO test stubs, extensive unit and integration tests, localization entries, CI/test grouping changes, and style-guideline and small syntactic refinements; several cmdlets adopt ShouldProcess/ConfirmImpact, Force, and terminating-error semantics.

Changes

Sequence Diagram(s)

sequenceDiagram
    autonumber
    participant User
    participant Cmdlet
    participant Helper as Get-AgentOperatorObject / Get-CommandParameter / ConvertTo-FormattedParameterDescription
    participant SMO as SMO Server / JobServer / Operator

    rect rgba(200,230,255,0.20)
    User->>Cmdlet: Invoke (e.g. New-/Set-/Remove-/Enable-/Disable-)
    Note right of Cmdlet: ParameterSet selection, Validate bound params
    end

    Cmdlet->>Cmdlet: Build ShouldProcess message
    alt Force supplied
        Cmdlet->>Cmdlet: Suppress confirmation (ConfirmPreference)
    else ShouldProcess check
        Cmdlet->>User: Prompt / WhatIf/Confirm
    end

    Cmdlet->>Helper: Resolve target / settable params
    Helper->>SMO: Query JobServer.Operators or Configuration (optional Refresh)
    SMO-->>Helper: Operator / ConfigProperty or null
    Helper-->>Cmdlet: Return target info

    alt Approved & target found
        Cmdlet->>SMO: Call Create()/Alter()/Drop()/Change ConfigValue
        SMO-->>Cmdlet: Success or throw
        opt Exception
            Cmdlet->>Cmdlet: ThrowTerminatingError(ErrorRecord with localized message/id/category/target)
        end
    else Target missing
        Cmdlet->>Cmdlet: Write-Error or ThrowTerminatingError (per command)
    end

    Cmdlet-->>User: Return result (object/boolean/none) or error

Estimated code review effort

🎯 5 (Critical) | ⏱️ ~180 minutes

Rationale: Large, heterogeneous changes touching public API surface, new cmdlets with ShouldProcess/Force/terminating-error semantics, many new private helpers, expanded SMO stubs, extensive unit and integration tests, localization additions, and CI updates — requires careful API/behavioral, tests, and localization review.

Possibly related PRs

• Add commands for SQL Server database management #2148 — Adds database management cmdlets (Get/New/Set/Remove/Test-SqlDscDatabase); strongly related to this PR's database-related additions.
• Refactor error handling, proper termination using ErrorActionPreference #2158 — Introduces scoped $ErrorActionPreference and refined ShouldProcess/ConfirmImpact patterns; closely related to the error-handling and confirmation semantics here.
• DSC Community guidelines instructions #2128 — Updates the PowerShell style-guideline instructions; related to the .github instruction edits in this change.

Pre-merge checks (2 passed, 1 warning)

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

@copilot the instructions has changed since this last was worked on, make sure the code and tests follow all instructions.

@copilot the instructions has changed since this last was worked on, make sure the code and tests follow all instructions.

Updated all Agent Operator source and test files to comply with current DSC community guidelines. Key changes include:

Test Setup Fixes:

• Changed $script:dscModuleName to $script:moduleName
• Added missing $PSDefaultParameterValues['InModuleScope:ModuleName']
• Set $env:SqlServerDscCI = $true BEFORE module import to prevent SMO type conflicts
• Added proper cleanup of all PSDefaultParameterValues

File Format Fixes:

• Added missing blank lines at end of all source files
• Ensured all test files end with blank lines

Validation:

• All Agent Operator unit tests now pass successfully
• Build process completes without errors
• Files follow exact required setup pattern from instructions

Commit 1113ccf

@copilot add to PowerShell instructions in the File Rules section that "no line shall have trailing whitespace": https://github.com/dsccommunity/SqlServerDsc/blob/main/.github/instructions/dsc-communi...

Added "No line shall have trailing whitespace" rule to the PowerShell style guidelines File Rules section. Commit fad08ed