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
    }
}