Согласно MS Документы:
Требования к набору параметров Следующие требования применяются ко всем наборам параметров.
Каждый набор параметров должен иметь хотя бы один уникальный параметр. Если возможно, сделайте этот параметр обязательным параметром.
Набор параметров, содержащий несколько позиционных параметров, должен определять уникальные позиции для каждого параметра. Никакие два позиционных параметра не могут указывать одну и ту же позицию.
Только один параметр в наборе может объявить ключевое слово ValueFromPipeline со значением true. Несколько параметров могут определять ключевое слово ValueFromPipelineByPropertyName со значением true.
Если для параметра не указан набор параметров, параметр принадлежит ко всем наборам параметров.
Это хорошая запись на эту тему, которая мне помогла. Вырезать это здесь, вместо того, чтобы просто дать вам ссылку, чтобы перейти к ней. Хотя это не относится к конкретному набору параметров, применяются те же правила.
Указание позиции параметра PowerShell
Для некоторых команд имеет смысл разрешить вам передавать вещи по положению, а не по имени, особенно в тех случаях, когда было бы мало путаницы, если бы имена параметров были опущены (как в этом примере).
function Test-Position
{
[CmdletBinding()]
Param
(
[parameter(Position=0)]$parm1,
[parameter(Position=1)]$parm2,
[parameter(Position=2)]$parm3,
[parameter(Position=3)]$parm4
)
}
Что я должен делать?
> Согласно справке (about_Functions_CmdletBindingAttribute), следует использовать необязательный аргумент PositionalBinding для атрибута CmdletBinding() и установить для него значение $false.
Это приведет к тому, что все параметры по умолчанию не будут разрешены по положению. Затем > вы можете указать позицию для любого (желательно только одного или двух) параметров, которые вы хотите использовать для позиции.
Например, это позволит использовать только $parm1 по положению:
function Test-Position
{
[CmdletBinding(PositionalBinding = $false)]
Param([parameter(Position=0)]$parm1,
$parm2,
$parm3,
$parm4)
}
Но подождите, становится легче
Несмотря на то, что в справке сказано, что все параметры по умолчанию являются позиционными, оказывается, что использование Position для одного параметра означает, что вы должны использовать его для любых параметров, к которым вы хотите получить доступ по положению.
Например, в этой версии функции я не указал ositionalBinding=$False в атрибуте CmdletBinding, а доступен только первый параметр по позиции.
function Test-Position2
{
[CmdletBinding()]
Param
(
[parameter(Position=0)]$parm1,
$parm2,
$parm3,
$parm4
)
}
Мне это интересно, так как кажется, что это противоречит тому, что есть в справке. Конкретно в хелпе написано, что все параметры позиционные. Затем он говорит, что для отключения этого значения по умолчанию следует использовать параметр PositionalBinding. Это показывает, что вам не нужно этого делать, если только вам не нужны никакие позиционные параметры.
В качестве последнего примера, просто чтобы убедиться, что мы понимаем, как используется значение Position, рассмотрим следующую справку по функциям и синтаксису:
function Test-Position3
{
[CmdletBinding()]
Param
(
$parm1,
$parm2,
[parameter(Position=1)]$parm3,
[parameter(Position=0)]$parm4
)
}
Включив Position в 2 параметра, мы добились того, что два других параметра доступны только по имени. Кроме того, назначенные позиции отличаются от порядка определения параметров в функции, что отражено в справке по синтаксису.
person
postanote
schedule
19.04.2020
