DynamicParams.psm1
|
[CmdletBinding()] param() $scriptName = 'DynamicParams' Write-Verbose "[$scriptName] - Importing module" #region - From [functions] - [public] Write-Verbose "[$scriptName] - [functions] - [public] - Processing folder" #region - From [functions] - [public] - [New-DynamicParam] Write-Verbose "[$scriptName] - [functions] - [public] - [New-DynamicParam] - Importing" function New-DynamicParam { <# .SYNOPSIS Creates a new dynamic parameter for a function. .DESCRIPTION Creates a new dynamic parameter for a function. .EXAMPLE dynamicparam { $DynamicParamDictionary = New-DynamicParamDictionary $dynParam = @{ Name = 'GitignoreTemplate' Alias = 'gitignore_template' Type = [string] ValidateSet = Get-GitHubGitignoreList DynamicParamDictionary = $DynamicParamDictionary } New-DynamicParam @dynParam $dynParam2 = @{ Name = 'LicenseTemplate' Alias = 'license_template' Type = [string] ValidateSet = Get-GitHubLicenseList | Select-Object -ExpandProperty key DynamicParamDictionary = $DynamicParamDictionary } New-DynamicParam @dynParam2 return $DynamicParamDictionary } .LINK https://psmodule.io/DynamicParams/Functions/New-DynamicParam/ #> [OutputType([void])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute( 'PSAvoidLongLines', '', Justification = 'Long links' )] [Diagnostics.CodeAnalysis.SuppressMessageAttribute( 'PSUseShouldProcessForStateChangingFunctions', '', Justification = 'Function does not change state.' )] [CmdletBinding()] param( # Specifies the name of the parameter. [Parameter(Mandatory)] [string] $Name, # Specifies the aliases of the parameter. [Parameter()] [string[]] $Alias, # Specifies the data type of the parameter. [Parameter()] [type] $Type, # Specifies the parameter set name. [Parameter()] [string] $ParameterSetName = '__AllParameterSets', # Specifies if the parameter is mandatory. # Parameter Set specific [Parameter()] [switch] $Mandatory, # Specifies the parameters positional binding. # Parameter Set specific [Parameter()] [int] $Position, # Specifies if the parameter accepts values from the pipeline. # Parameter Set specific [Parameter()] [switch] $ValueFromPipeline, # Specifies if the parameter accepts values from the pipeline by property name. # Parameter Set specific [Parameter()] [switch] $ValueFromPipelineByPropertyName, # Specifies if the parameter accepts values from the remaining command-line arguments that are not associated with another parameter. # Parameter Set specific [Parameter()] [switch] $ValueFromRemainingArguments, # Specifies the help message of the parameter. # Parameter Set specific [Parameter()] [string] $HelpMessage, # Specifies the comments of the parameter. [Parameter()] [string] $Comment, # Specifies the validate script of the parameter. [Parameter()] [scriptblock] $ValidateScript, # Specifies the validate regular expression pattern of the parameter. [Parameter()] [regex] $ValidatePattern, # Specifies the validate regular expression pattern options of the parameter. # For more info see [RegexOptions](https://learn.microsoft.com/dotnet/api/system.text.regularexpressions.regexoptions). [Parameter()] [System.Text.RegularExpressions.RegexOptions[]] $ValidatePatternOptions, # Specifies the validate number of items for the parameter. [Parameter()] [ValidateCount(2, 2)] [int[]] $ValidateCount, # Specifies the validate range of the parameter. [Parameter()] [object] $ValidateRange, # Specifies the validate set of the parameter. [Parameter()] [object] $ValidateSet, # Specifies the validate length of the parameter. [Parameter()] [ValidateCount(2, 2)] [int[]] $ValidateLength, # Specifies if the parameter accepts null or empty values. [Parameter()] [switch] $ValidateNotNullOrEmpty, # The custom error message pattern that is displayed to the user if validation fails. # This parameter is not supported on Windows PowerShell Desktop Edition, if specified it will be ignored. # # Examples of how to use this parameter: # - `ValidatePattern` -> "The text '{0}' did not pass validation of the regular expression '{1}'". {0} is the value, {1} is the pattern. # - `ValidateSet` -> "The item '{0}' is not part of the set '{1}'. {0} is the value, {1} is the set. # - `ValidateScript` -> "The item '{0}' did not pass validation of script '{1}'". {0} is the value, {1} is the script. [Parameter()] [string] $ValidationErrorMessage, # Specifies if the parameter accepts wildcards. [Parameter()] [switch] $SupportsWildcards, # Specifies if the parameter accepts empty strings. [Parameter()] [switch] $AllowEmptyString, # Specifies if the parameter accepts null values. [Parameter()] [switch] $AllowNull, # Specifies if the parameter accepts empty collections. [Parameter()] [switch] $AllowEmptyCollection, # Specifies the dynamic parameter dictionary. [Parameter()] [System.Management.Automation.RuntimeDefinedParameterDictionary] $DynamicParamDictionary ) $isDesktop = $PSVersionTable.PSEdition -eq 'Desktop' if ($isDesktop) { if ($PSBoundParameters.ContainsKey('ValidationErrorMessage')) { Write-Warning "Unsupported parameter: 'ValidationErrorMessage' is not supported in Windows PowerShell Desktop Edition. Skipping it." } } $attributeCollection = New-Object System.Collections.ObjectModel.Collection[System.Attribute] # foreach ParameterSet in ParameterSets , Key = name, Value = Hashtable $parameterAttribute = [System.Management.Automation.ParameterAttribute]::new() $parameterAttribute.ParameterSetName = $ParameterSetName if ($PSBoundParameters.ContainsKey('HelpMessage')) { $parameterAttribute.HelpMessage = $HelpMessage } if ($PSBoundParameters.ContainsKey('Position')) { $parameterAttribute.Position = $Position } $parameterAttribute.Mandatory = $Mandatory $parameterAttribute.ValueFromPipeline = $ValueFromPipeline $parameterAttribute.ValueFromPipelineByPropertyName = $ValueFromPipelineByPropertyName $parameterAttribute.ValueFromRemainingArguments = $ValueFromRemainingArguments $attributeCollection.Add($parameterAttribute) if ($PSBoundParameters.ContainsKey('Alias')) { $Alias | ForEach-Object { $aliasAttribute = New-Object System.Management.Automation.AliasAttribute($_) $attributeCollection.Add($aliasAttribute) } } # TODO: Add ability to add a param doc/comment if ($PSBoundParameters.ContainsKey('ValidateSet')) { $validateSetAttribute = New-Object System.Management.Automation.ValidateSetAttribute($ValidateSet) if ($PSBoundParameters.ContainsKey('ValidationErrorMessage') -and -not $isDesktop) { $validateSetAttribute.ErrorMessage = $ValidationErrorMessage } $attributeCollection.Add($validateSetAttribute) } if ($PSBoundParameters.ContainsKey('ValidateNotNullOrEmpty')) { $validateSetAttribute = New-Object System.Management.Automation.ValidateNotNullOrEmptyAttribute $attributeCollection.Add($validateSetAttribute) } if ($PSBoundParameters.ContainsKey('ValidateLength')) { $validateLengthAttribute = New-Object System.Management.Automation.ValidateLengthAttribute($ValidateLength[0], $ValidateLength[1]) $attributeCollection.Add($validateLengthAttribute) } if ($PSBoundParameters.ContainsKey('ValidateCount')) { $validateCountAttribute = New-Object System.Management.Automation.ValidateCountAttribute($ValidateCount[0], $ValidateCount[1]) $attributeCollection.Add($validateCountAttribute) } if ($PSBoundParameters.ContainsKey('ValidateScript')) { $validateScriptAttribute = New-Object System.Management.Automation.ValidateScriptAttribute($ValidateScript) if ($PSBoundParameters.ContainsKey('ValidationErrorMessage') -and -not $isDesktop) { $validateScriptAttribute.ErrorMessage = $ValidationErrorMessage } $attributeCollection.Add($validateScriptAttribute) } if ($PSBoundParameters.ContainsKey('ValidatePattern')) { $validatePatternAttribute = New-Object System.Management.Automation.ValidatePatternAttribute($ValidatePattern) if ($PSBoundParameters.ContainsKey('ValidationErrorMessage') -and -not $isDesktop) { $validatePatternAttribute.ErrorMessage = $ValidationErrorMessage } if ($PSBoundParameters.ContainsKey('ValidatePatternOptions')) { $validatePatternAttribute.Options = $ValidatePatternOptions } $attributeCollection.Add($validatePatternAttribute) } if ($PSBoundParameters.ContainsKey('ValidateRange')) { $validateRangeAttribute = New-Object System.Management.Automation.ValidateRangeAttribute($ValidateRange) $attributeCollection.Add($validateRangeAttribute) } if ($PSBoundParameters.ContainsKey('SupportsWildcards')) { $supportsWildcardsAttribute = New-Object System.Management.Automation.SupportsWildcardsAttribute $attributeCollection.Add($supportsWildcardsAttribute) } if ($PSBoundParameters.ContainsKey('AllowEmptyString')) { $allowEmptyStringAttribute = New-Object System.Management.Automation.AllowEmptyStringAttribute $attributeCollection.Add($allowEmptyStringAttribute) } if ($PSBoundParameters.ContainsKey('AllowNull')) { $allowNullAttribute = New-Object System.Management.Automation.AllowNullAttribute $attributeCollection.Add($allowNullAttribute) } if ($PSBoundParameters.ContainsKey('AllowEmptyCollection')) { $allowEmptyCollectionAttribute = New-Object System.Management.Automation.AllowEmptyCollectionAttribute $attributeCollection.Add($allowEmptyCollectionAttribute) } $runtimeDefinedParameter = New-Object System.Management.Automation.RuntimeDefinedParameter($Name, $Type, $attributeCollection) $DynamicParamDictionary.Add($Name, $runtimeDefinedParameter) } Write-Verbose "[$scriptName] - [functions] - [public] - [New-DynamicParam] - Done" #endregion - From [functions] - [public] - [New-DynamicParam] #region - From [functions] - [public] - [New-DynamicParamDictionary] Write-Verbose "[$scriptName] - [functions] - [public] - [New-DynamicParamDictionary] - Importing" function New-DynamicParamDictionary { <# .SYNOPSIS Creates a new RuntimeDefinedParameterDictionary .DESCRIPTION Creates a new RuntimeDefinedParameterDictionary .EXAMPLE New-DynamicParamDictionary Returns a new RuntimeDefinedParameterDictionary .LINK https://psmodule.io/DynamicParams/Functions/New-DynamicParamDictionary/ #> [OutputType([System.Management.Automation.RuntimeDefinedParameterDictionary])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute( 'PSUseShouldProcessForStateChangingFunctions', '', Justification = 'Function does not change state.' )] [CmdletBinding()] param() [System.Management.Automation.RuntimeDefinedParameterDictionary]::new() } Write-Verbose "[$scriptName] - [functions] - [public] - [New-DynamicParamDictionary] - Done" #endregion - From [functions] - [public] - [New-DynamicParamDictionary] Write-Verbose "[$scriptName] - [functions] - [public] - Done" #endregion - From [functions] - [public] $exports = @{ Alias = '*' Cmdlet = '' Function = @( 'New-DynamicParam' 'New-DynamicParamDictionary' ) } Export-ModuleMember @exports |