Private/Association/Get-DynamicParamAssociation.ps1
|
Function Get-DynamicParamAssociation { Param( [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The verb of the command calling it. Different verbs will make different parameters required.')][ValidateSet('add', 'copy', 'get', 'new', 'remove', 'set')][System.String]$Action , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The type of the object.')][ValidateNotNullOrEmpty()][ValidateSet('command', 'ldap_server', 'policy', 'application', 'radius_server', 'system_group', 'system', 'user_group', 'user', 'g_suite', 'office_365')][Alias('TypeNameSingular')][System.String]$Type , [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Bypass user prompts and dynamic ValidateSet.')][ValidateNotNullOrEmpty()][Switch]$Force ) Begin { $RuntimeParameterDictionary = If ($Type) { Get-JCCommonParameters -Force:($Force) -Action:($Action) -Type:($Type); } Else { Get-JCCommonParameters -Force:($Force) -Action:($Action); } # Get type list $JCType = If ($Type) { Get-JCType -Type:($Type); } Else { Get-JCType; } } Process { # Define the new parameters $Param_Id = @{ 'Name' = 'Id'; 'Type' = [System.String[]]; 'Mandatory' = $true; 'ValueFromPipelineByPropertyName' = $true; 'ValidateNotNullOrEmpty' = $true; 'ParameterSets' = @('ById'); 'HelpMessage' = 'The unique id of the object.'; 'Alias' = $JCType.ById | Where-Object { $_ -ne 'Id' } | Select-Object -Unique; 'Position' = 1; } $Param_Name = @{ 'Name' = 'Name'; 'Type' = [System.String[]]; 'Mandatory' = $true; 'ValueFromPipelineByPropertyName' = $true; 'ValidateNotNullOrEmpty' = $true; 'ParameterSets' = @('ByName'); 'HelpMessage' = 'The name of the object.'; 'Alias' = $JCType.ByName | Where-Object { $_ -ne 'Name' } | Select-Object -Unique; 'Position' = 1; } $Param_TargetType = @{ 'Name' = 'TargetType'; 'Type' = [System.String[]]; 'Mandatory' = $false; 'ValueFromPipelineByPropertyName' = $true; 'ValidateNotNullOrEmpty' = $true; 'Alias' = ('TargetSingular'); 'HelpMessage' = 'The type of the target object.'; 'ValidateSet' = $JCType.Targets.TargetSingular | Select-Object -Unique; 'DefaultValue' = $JCType.Targets.TargetSingular | Select-Object -Unique; 'Position' = 2; } $Param_associationType = @{ 'Name' = 'associationType'; 'Type' = [System.String[]]; 'ValueFromPipelineByPropertyName' = $true; 'ValidateSet' = @("direct", "direct`/indirect", "indirect"); 'DontShow' = $true; 'HelpMessage' = 'Used for piping only to determine type of association when coming from Add-JCAssociation or Remove-JCAssociation.'; 'Mandatory' = $false; 'Position' = 3; } $Param_Raw = @{ 'Name' = 'Raw'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'DontShow' = $true; 'HelpMessage' = 'Returns the raw and unedited output from the api endpoint.'; 'Position' = 4; } $Param_Direct = @{ 'Name' = 'Direct'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'HelpMessage' = 'Returns only "Direct" associations.'; 'Position' = 5; } $Param_Indirect = @{ 'Name' = 'Indirect'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'HelpMessage' = 'Returns only "Indirect" associations.'; 'Position' = 6; } $Param_IncludeInfo = @{ 'Name' = 'IncludeInfo'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'HelpMessage' = 'Appends "Info" and "TargetInfo" properties to output.'; 'Position' = 7; } $Param_IncludeNames = @{ 'Name' = 'IncludeNames'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'HelpMessage' = 'Appends "Name" and "TargetName" properties to output.'; 'Position' = 8; } $Param_IncludeVisualPath = @{ 'Name' = 'IncludeVisualPath'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'HelpMessage' = 'Appends "visualPathById", "visualPathByName", and "visualPathByType" properties to output.'; 'Position' = 9; } $Param_TargetId = @{ 'Name' = 'TargetId'; 'Type' = [System.String]; 'ValueFromPipelineByPropertyName' = $true; 'HelpMessage' = 'The unique id of the target object.'; 'Position' = 10; } $Param_TargetName = @{ 'Name' = 'TargetName'; 'Type' = [System.String]; 'ValueFromPipelineByPropertyName' = $true; 'HelpMessage' = 'The name of the target object.'; 'Position' = 11; } $Param_Attributes = @{ 'Name' = 'Attributes'; 'Type' = [System.Management.Automation.PSObject]; 'ValueFromPipelineByPropertyName' = $true; 'Alias' = 'compiledAttributes'; 'HelpMessage' = 'Add attributes that define the association such as if they are an admin.'; 'Position' = 12; } $Param_RemoveExisting = @{ 'Name' = 'RemoveExisting'; 'Type' = [Switch]; 'ValueFromPipelineByPropertyName' = $true; 'DefaultValue' = $false; 'HelpMessage' = 'Removes the existing associations while still adding the new associations.'; 'Position' = 13; } $Param_IncludeType = @{ 'Name' = 'IncludeType'; 'Type' = [System.String[]]; 'Mandatory' = $false; 'ValueFromPipelineByPropertyName' = $true; 'ValidateNotNullOrEmpty' = $true; 'HelpMessage' = 'Specify the association types to include in the copy.'; 'ValidateSet' = $JCType.Targets.TargetSingular | Select-Object -Unique; 'DefaultValue' = $JCType.Targets.TargetSingular | Select-Object -Unique; 'Position' = 14; } $Param_ExcludeType = @{ 'Name' = 'ExcludeType'; 'Type' = [System.String[]]; 'Mandatory' = $false; 'ValueFromPipelineByPropertyName' = $true; 'ValidateNotNullOrEmpty' = $true; 'HelpMessage' = 'Specify the association types to exclude from the copy.'; 'ValidateSet' = $JCType.Targets.TargetSingular | Select-Object -Unique; 'Position' = 15; } # Build output $ParamVarPrefix = 'Param_' Get-Variable -Scope:('Local') | Where-Object { $_.Name -like '*' + $ParamVarPrefix + '*' } | Sort-Object { [int]$_.Value.Position } | ForEach-Object { # Add RuntimeDictionary to each parameter $_.Value.Add('RuntimeParameterDictionary', $RuntimeParameterDictionary) # Creating each parameter $VarName = $_.Name $VarValue = $_.Value Try { If ($Action -in ('add', 'new') -and $_.Name -in ('Param_Id', 'Param_TargetType', 'Param_TargetId', 'Param_TargetName', 'Param_associationType', 'Param_Attributes')) { New-DynamicParameter @VarValue | Out-Null } ElseIf ($Action -in ('remove') -and $_.Name -in ('Param_Name', 'Param_TargetType', 'Param_TargetId', 'Param_TargetName', 'Param_associationType')) { New-DynamicParameter @VarValue | Out-Null } # ElseIf ($Action -in ('set') -and $_.Name -in ('')) # { # New-DynamicParameter @VarValue | Out-Null # } ElseIf ($Action -eq 'get' -and $_.Name -in ('Param_TargetType', 'Param_Raw', 'Param_Direct', 'Param_Indirect', 'Param_IncludeInfo', 'Param_IncludeNames', 'Param_IncludeVisualPath')) { New-DynamicParameter @VarValue | Out-Null } ElseIf ($Action -eq 'copy' -and $_.Name -in ('Param_TargetId', 'Param_TargetName', 'Param_RemoveExisting', 'Param_IncludeType', 'Param_ExcludeType')) { New-DynamicParameter @VarValue | Out-Null } } Catch { Write-Error -Message:('Unable to create dynamic parameter:"' + $VarName.Replace($ParamVarPrefix, '') + '"; Error:' + $Error) } } } End { Return $RuntimeParameterDictionary } } |