PowerShell. Можно ли привязать параметр New-Item -Value ByPropertyName?

Можно ли привязать New-Item -Value параметр ByPropertyName?

Нет, потому что, как вы уже заметили, тип параметра — System.Object , и, поскольку все объекты наследуются от этого класса, каждый ввод из конвейера связан с ValueFromPipeline вместо ValueFromPipelineByPropertyName.

Должен ли тип этого параметра быть отличным от System.Object?

Нет, потому что это будет конфликтовать с другими провайдерами. Например, определение новой функции больше невозможно:

$null = New-Item -Path function:Say-Hello -Value {
    'hey there'
}

Say-Hello

Следует ли включить параметр -Value для привязки по имени свойства?

Вероятно, нет, потому что он никогда не может быть связан им.

Есть ли обходной путь?

У вас может быть ProxyCommand или функция-оболочка вокруг New-Item, которая изменяет тип параметра с System.Object на System.String, таким образом, функция сможет работать правильно, принимая ValueFromPipeline и ValueFromPipelineByPropertyName. Затем вы можете сохранить эту оболочку в своем $PROFILE и иметь ее доступной для вас каждый раз, когда начинается новый сеанс.

По причинам, изложенным ранее, эта оболочка будет работать только с провайдером файловой системы и жестко закодирована для ItemType = File.

function New-File {
    [CmdletBinding(DefaultParameterSetName='pathSet', SupportsShouldProcess=$true, ConfirmImpact='Medium', HelpUri='https://go.microsoft.com/fwlink/?LinkID=2096592')]
    param(
        [Parameter(ParameterSetName='pathSet', Mandatory=$true, Position=0, ValueFromPipelineByPropertyName=$true)]
        [Parameter(ParameterSetName='nameSet', Position=0, ValueFromPipelineByPropertyName=$true)]
        [string[]]
        ${Path},

        [Parameter(ParameterSetName='nameSet', Mandatory=$true, ValueFromPipelineByPropertyName=$true)]
        [AllowNull()]
        [AllowEmptyString()]
        [string]
        ${Name},

        [Parameter(ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)]
        [Alias('Target')]
        [string]
        ${Value},

        [switch]
        ${Force}
    )

    begin {
        try {
            $outBuffer = $null
            if ($PSBoundParameters.TryGetValue('OutBuffer', [ref] $outBuffer)) {
                $PSBoundParameters['OutBuffer'] = 1
            }

            $PSBoundParameters['ItemType'] = 'File'

            $wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand('Microsoft.PowerShell.Management\New-Item', [System.Management.Automation.CommandTypes]::Cmdlet)
            $scriptCmd = { & $wrappedCmd @PSBoundParameters }

            $steppablePipeline = $scriptCmd.GetSteppablePipeline($myInvocation.CommandOrigin)
            $steppablePipeline.Begin($PSCmdlet)
        }
        catch {
            $PSCmdlet.ThrowTerminatingError($_)
        }
    }

    process {
        try {
            $steppablePipeline.Process($Value)
        }
        catch {
            $PSCmdlet.ThrowTerminatingError($_)
        }
    }

    end {
        try {
            $steppablePipeline.End()
        } catch {
            $PSCmdlet.ThrowTerminatingError($_)
        }
    }
    <#
    .ForwardHelpTargetName Microsoft.PowerShell.Management\New-Item
    .ForwardHelpCategory Cmdlet
    #>
}

[PSCustomObject]@{ Value = "Lorem ipsum" } | New-File .\BPN_value.txt -Force
"Lorem ipsum" | New-File .\BPN_value2.txt -Force

Для справки, определение кода, использованного выше, было сгенерировано автоматически с использованием:

[System.Management.Automation.ProxyCommand]::Create((Get-Command New-Item))

Затем он был немного изменен и упрощен для этого конкретного ответа.

Это возможно, если значения параметра -Path или -Name также являются свойством объекта в пайплайне:

[PSCustomObject]@{
    name = 'TestFile'
    value = 'Hello World'
} | New-Item

Захват консоли:

PS ScratchPad> [PSCustomObject]@{
>>     Name = 'TestFile'
>>     value = 'Hello World'
>> } | New-Item


    Directory: C:\ScratchPad


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        11/23/2022  12:07 AM             35 TestFile

Или:

PS ScratchPad> [PSCustomObject]@{
>>     Path = "$Home\Documents\TestFile.txt"
>>     value = 'Hello World'
>> } | New-Item


    Directory: C:\Users\keith\Documents


Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        11/23/2022  12:27 AM             64 TestFile.txt

Но почему-то не любит -Path + -Name:

PS ScratchPad> [PSCustomObject]@{
>>     Path = "$Home\Documents"
>>     Name = 'TestFile'
>>     value = 'Hello World'
>> } | New-Item
New-Item : Access to the path 'C:\Users\keith\Documents' is denied.
At line:5 char:5
+ } | New-Item
+     ~~~~~~~~
    + CategoryInfo          : PermissionDenied: (C:\Users\keith\Documents:String) [New
   -Item], UnauthorizedAccessException
    + FullyQualifiedErrorId : NewItemUnauthorizedAccessError,Microsoft.PowerShell.Comm
   ands.NewItemCommand