Как вы поддерживаете параметры PowerShell -WhatIf & -Confirm в командлете, который вызывает другие командлеты?

Явная передача параметров

Вы можете передать параметры -WhatIf и -Confirm с переменными $WhatIfPreference и $ConfirmPreference. В следующем примере это достигается с помощью параметра splatting< /а>:

if($ConfirmPreference -eq 'Low') {$conf = @{Confirm = $true}}

StopService MyService -WhatIf:([bool]$WhatIfPreference.IsPresent) @conf

function ShouldTestCallee {
    [cmdletBinding(SupportsShouldProcess=$true,ConfirmImpact='Medium')] 
    param($test)

    $PSCmdlet.ShouldProcess($env:COMPUTERNAME,"Confirm?")
}


function ShouldTestCaller {
    [cmdletBinding(SupportsShouldProcess=$true)]
    param($test)

    ShouldTestCallee
}

$ConfirmPreference = 'High'
ShouldTestCaller
ShouldTestCaller -Confirm

После некоторого поиска в Google я нашел хорошее решение для передачи общих параметров вместе с вызываемыми командами. Вы можете использовать оператор @splatting для передачи всех параметров, которые были переданы вашей команде. Например, если

Start-Service -Name ServiceAbc @PSBoundParameters

находится в теле вашего скрипта, powershell передаст все параметры, которые были переданы вашему скрипту, в команду Start-Service. Единственная проблема заключается в том, что если ваш сценарий содержит, скажем, параметр -Name, он также будет передан, и PowerShell будет жаловаться, что вы дважды включили параметр -Name. Я написал следующую функцию, чтобы скопировать все общие параметры в новый словарь, а затем добавил это.

function Select-BoundCommonParameters
{
    [CmdletBinding()]
    param(
        [Parameter(Mandatory=$true)]
        $BoundParameters
    )
    begin
    {
        $boundCommonParameters = New-Object -TypeName 'System.Collections.Generic.Dictionary[string, [Object]]'
    }
    process
    {
        $BoundParameters.GetEnumerator() |
            Where-Object { $_.Key -match 'Debug|ErrorAction|ErrorVariable|WarningAction|WarningVariable|Verbose' } |
            ForEach-Object { $boundCommonParameters.Add($_.Key, $_.Value) }

        $boundCommonParameters
    }
}

Конечным результатом является то, что вы передаете такие параметры, как -Verbose, вместе с командами, вызываемыми в вашем сценарии, и они учитывают намерение вызывающего абонента.

Вот полное решение, основанное на ответах @Rynant и @Shay Levy:

function Stop-CompanyXyzServices
{
    [CmdletBinding(SupportsShouldProcess=$true,ConfirmImpact='Medium')]

    Param(
        [Parameter(
            Position=0,
            ValueFromPipeline=$true,
            ValueFromPipelineByPropertyName=$true
        )]      
        [string]$Name
    )

    process
    {
        if($PSCmdlet.ShouldProcess($env:COMPUTERNAME,"Stop XYZ services '$Name'")){  
            ActualCmdletProcess
        }
        if([bool]$WhatIfPreference.IsPresent){
            ActualCmdletProcess
        }
    }
}

function ActualCmdletProcess{
# add here the actual logic of your cmdlet, and any call to other cmdlets
Stop-Service $name -WhatIf:([bool]$WhatIfPreference.IsPresent) -Confirm:("Low","Medium" -contains $ConfirmPreference)
}

Мы также должны проверить, передается ли -WhatIf отдельно, чтобы можно было передать whatif отдельным командлетам. ActualCmdletProcess в основном представляет собой рефакторинг, чтобы вы не вызывали один и тот же набор команд снова только для WhatIf. Надеюсь, это поможет кому-то.

Обновлено в соответствии с комментарием @manojlds

Приведите $WhatIf и $Confirm к Boolean и передайте значения базовому командлету:

function Stop-CompanyXyzServices
{
    [CmdletBinding(SupportsShouldProcess=$true,ConfirmImpact='High')]

    Param(
        [Parameter(
            Position=0,
            ValueFromPipeline=$true,
            ValueFromPipelineByPropertyName=$true
        )]      
        [string]$Name
    )


    process
    {
        if($PSCmdlet.ShouldProcess($env:COMPUTERNAME,"Stop service '$Name'"))
        {                   
            Stop-Service $name -WhatIf:([bool]$WhatIf) -Confirm:([bool]$confirm)
        }                       
    }
}