Functions/Test-IsClearCurrentValueFlag.ps1

<#
.SYNOPSIS
    This function returns whether a value is the value of the 'clear current value' flag.
.DESCRIPTION
    This function returns whether a value is the value of the 'clear current value' flag.
    This flag is used to indicate when updating a property that the current value should be cleared.
#>

function Test-IsClearCurrentValueFlag {
    [CmdletBinding(PositionalBinding=$true)]
    [OutputType([Bool])]
    param (
        [Parameter(Mandatory=$true)]
        [AllowNull()]
        $value
    )

    # Return whether the value is the 'clear current value' flag
    return $value -is [String] -and $value -eq "-ClearValue"
}