Skip to content

Latest commit

 

History

History
123 lines (102 loc) · 2.24 KB

File metadata and controls

123 lines (102 loc) · 2.24 KB
description Use identical parameters for DSC Get, Set, and Test TargetResource functions in a resource
ms.date 07/21/2026
ms.topic reference
title DSCUseIdenticalParametersForDSC

UseIdenticalParametersForDSC

Severity Level: Error

Default state: Always enabled

Description

This rule detects if the Get-TargetResource, Set-TargetResource, and Test-TargetResource functions in a Desired State Configuration (DSC) resource all have identical parameters. If they don't match, you'll need to update the function parameters to be consistent across all three functions.

Example

Noncompliant

function Get-TargetResource
{
    [OutputType([Hashtable])]
    param
    (
        [parameter(Mandatory = $true)]
        [String]
        $Name,

        [String]
        $TargetResource
    )
    ...
}

function Set-TargetResource
{
    param
    (
        [parameter(Mandatory = $true)]
        [String]
        $Name
    )
    ...
}

function Test-TargetResource
{
    [OutputType([System.Boolean])]
    param
    (
        [parameter(Mandatory = $true)]
        [String]
        $Name
    )
    ...
}

Compliant

function Get-TargetResource
{
    [OutputType([Hashtable])]
    param
    (
        [parameter(Mandatory = $true)]
        [String]
        $Name,

        [String]
        $TargetResource
    )
    ...
}

function Set-TargetResource
{
    param
    (
        [parameter(Mandatory = $true)]
        [String]
        $Name,

        [String]
        $TargetResource
    )
    ...
}

function Test-TargetResource
{
    [OutputType([System.Boolean])]
    param
    (
        [parameter(Mandatory = $true)]
        [String]
        $Name,

        [String]
        $TargetResource
    )
    ...
}

Configure rule

This rule is always enabled and isn't configurable. Use one of the following methods to avoid using this rule:

  • Create a custom rule configuration file to include only the rules you want or exclude the rules you don't want.
  • Add the appropriate rule suppression attributes to your code to suppress the rule for specific code blocks. For more information, see the Suppressing rules section of Using PSScriptAnalyzer.