PowerShellForGitHub

0.15.1

GitHubAssignees.ps1

                                # Copyright (c) Microsoft Corporation. All rights reserved.

# Licensed under the MIT License.

filter Get-GitHubAssignee

{

<#

    .DESCRIPTION

        Lists the available assignees for issues in a repository.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER OwnerName

        Owner of the repository.

        If not supplied here, the DefaultOwnerName configuration property value will be used.

    .PARAMETER RepositoryName

        Name of the repository.

        If not supplied here, the DefaultRepositoryName configuration property value will be used.

    .PARAMETER Uri

        Uri for the repository.

        The OwnerName and RepositoryName will be extracted from here instead of needing to provide

        them individually.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .INPUTS

        GitHub.Branch

        GitHub.Content

        GitHub.Event

        GitHub.Issue

        GitHub.IssueComment

        GitHub.Label

        GitHub.Milestone

        GitHub.PullRequest

        GitHub.Project

        GitHub.ProjectCard

        GitHub.ProjectColumn

        GitHub.Reaction

        GitHub.Release

        GitHub.ReleaseAsset

        GitHub.Repository

        GitHub.User

    .OUTPUTS

        GitHub.User

    .EXAMPLE

        Get-GitHubAssigneeList -OwnerName microsoft -RepositoryName PowerShellForGitHub

        Lists the available assignees for issues from the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $repo = Get-GitHubRepository -OwnerName microsoft -RepositoryName PowerShellForGitHub

        $repo | Get-GitHubAssigneeList

        Lists the available assignees for issues from the microsoft\PowerShellForGitHub project.

#>

    [CmdletBinding(DefaultParameterSetName = 'Elements')]

    [OutputType({$script:GitHubUserTypeName})]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="The Uri parameter is only referenced by Resolve-RepositoryElements which get access to it from the stack via Get-Variable -Scope 1.")]

    param(

        [Parameter(ParameterSetName='Elements')]

        [string] $OwnerName,

        [Parameter(ParameterSetName='Elements')]

        [string] $RepositoryName,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName,

            ParameterSetName='Uri')]

        [Alias('RepositoryUrl')]

        [string] $Uri,

        [string] $AccessToken

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{

        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

    }

    $params = @{

        'UriFragment' = "repos/$OwnerName/$RepositoryName/assignees"

        'Description' = "Getting assignee list for $RepositoryName"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

    }

    return (Invoke-GHRestMethodMultipleResult @params | Add-GitHubUserAdditionalProperties)

}

filter Test-GitHubAssignee

{

<#

    .DESCRIPTION

        Checks if a user has permission to be assigned to an issue in this repository.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER OwnerName

        Owner of the repository.

        If not supplied here, the DefaultOwnerName configuration property value will be used.

    .PARAMETER RepositoryName

        Name of the repository.

        If not supplied here, the DefaultRepositoryName configuration property value will be used.

    .PARAMETER Uri

        Uri for the repository.

        The OwnerName and RepositoryName will be extracted from here instead of needing to provide

        them individually.

    .PARAMETER Assignee

        Username for the assignee

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .INPUTS

        GitHub.Branch

        GitHub.Content

        GitHub.Event

        GitHub.Issue

        GitHub.IssueComment

        GitHub.Label

        GitHub.Milestone

        GitHub.PullRequest

        GitHub.Project

        GitHub.ProjectCard

        GitHub.ProjectColumn

        GitHub.Reaction

        GitHub.Release

        GitHub.ReleaseAsset

        GitHub.Repository

        GitHub.User

    .OUTPUTS

        [bool]

        If the assignee can be assigned to issues in the repository.

    .EXAMPLE

        Test-GitHubAssignee -OwnerName microsoft -RepositoryName PowerShellForGitHub -Assignee "LoginID123"

        Checks if a user has permission to be assigned to an issue

        from the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $repo = Get-GitHubRepository -OwnerName microsoft -RepositoryName PowerShellForGitHub

        $repo | Test-GitHubAssignee -Assignee 'octocat'

        Checks if a user has permission to be assigned to an issue

        from the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $octocat = Get-GitHubUser -UserName 'octocat'

        $repo = $octocat | Test-GitHubAssignee -OwnerName microsoft -RepositoryName PowerShellForGitHub

        Checks if a user has permission to be assigned to an issue

        from the microsoft\PowerShellForGitHub project.

#>

    [CmdletBinding(DefaultParameterSetName = 'Elements')]

    [OutputType([bool])]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="The Uri parameter is only referenced by Resolve-RepositoryElements which get access to it from the stack via Get-Variable -Scope 1.")]

    param(

        [Parameter(ParameterSetName='Elements')]

        [string] $OwnerName,

        [Parameter(ParameterSetName='Elements')]

        [string] $RepositoryName,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName,

            ParameterSetName='Uri')]

        [Alias('RepositoryUrl')]

        [string] $Uri,

        [Parameter(ValueFromPipelineByPropertyName)]

        [Alias('UserName')]

        [string] $Assignee,

        [string] $AccessToken

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{

        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

        'Assignee' = (Get-PiiSafeString -PlainText $Assignee)

    }

    $params = @{

        'UriFragment' = "repos/$OwnerName/$RepositoryName/assignees/$Assignee"

        'Method' = 'Get'

        'Description' = "Checking permission for $Assignee for $RepositoryName"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'ExtendedResult'= $true

    }

    try

    {

        $response = Invoke-GHRestMethod @params

        return $response.StatusCode -eq 204

    }

    catch

    {

        return $false

    }

}

function Add-GitHubAssignee

{

<#

    .DESCRIPTION

       Adds a list of assignees to a GitHub Issue for the given repository.

       The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER OwnerName

        Owner of the repository.

        If not supplied here, the DefaultOwnerName configuration property value will be used.

    .PARAMETER RepositoryName

        Name of the repository.

        If not supplied here, the DefaultRepositoryName configuration property value will be used.

    .PARAMETER Uri

        Uri for the repository.

        The OwnerName and RepositoryName will be extracted from here instead of needing to provide

        them individually.

    .PARAMETER Issue

        Issue number to add the assignees to.

    .PARAMETER Assignee

        Usernames of users to assign this issue to.

        NOTE: Only users with push access can add assignees to an issue.

        Assignees are silently ignored otherwise.

    .PARAMETER PassThru

        Returns the updated GitHub Issue.  By default, this cmdlet does not generate any output.

        You can use "Set-GitHubConfiguration -DefaultPassThru" to control the default behavior

        of this switch.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .INPUTS

        GitHub.Branch

        GitHub.Content

        GitHub.Event

        GitHub.Issue

        GitHub.IssueComment

        GitHub.Label

        GitHub.Milestone

        GitHub.PullRequest

        GitHub.Project

        GitHub.ProjectCard

        GitHub.ProjectColumn

        GitHub.Reaction

        GitHub.Release

        GitHub.ReleaseAsset

        GitHub.Repository

        GitHub.User

    .OUTPUTS

        GitHub.Issue

    .EXAMPLE

        $assignees = @('octocat')

        Add-GitHubAssignee -OwnerName microsoft -RepositoryName PowerShellForGitHub -Issue 1 -Assignee $assignee

        Additionally assigns the usernames in $assignee to Issue #1

        from the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $assignees = @('octocat')

        $repo = Get-GitHubRepository -OwnerName microsoft -RepositoryName PowerShellForGitHub

        $repo | Add-GitHubAssignee -Issue 1 -Assignee $assignee

        Additionally assigns the usernames in $assignee to Issue #1

        from the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $assignees = @('octocat')

        Get-GitHubRepository -OwnerName microsoft -RepositoryName PowerShellForGitHub |

            Get-GitHubIssue -Issue 1 |

            Add-GitHubAssignee -Assignee $assignee

        Additionally assigns the usernames in $assignee to Issue #1

        from the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $octocat = Get-GitHubUser -UserName 'octocat'

        $octocat | Add-GitHubAssignee -OwnerName microsoft -RepositoryName PowerShellForGitHub -Issue 1

        Additionally assigns the user 'octocat' to Issue #1

        from the microsoft\PowerShellForGitHub project.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParameterSetName='Elements')]

    [OutputType({$script:GitHubIssueTypeName})]

    [Alias('New-GitHubAssignee')] # Non-standard usage of the New verb, but done to avoid a breaking change post 0.14.0

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="The Uri parameter is only referenced by Resolve-RepositoryElements which get access to it from the stack via Get-Variable -Scope 1.")]

    param(

        [Parameter(ParameterSetName='Elements')]

        [string] $OwnerName,

        [Parameter(ParameterSetName='Elements')]

        [string] $RepositoryName,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName,

            ParameterSetName='Uri')]

        [Alias('RepositoryUrl')]

        [string] $Uri,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName)]

        [Alias('IssueNumber')]

        [int64] $Issue,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName)]

        [ValidateCount(1, 10)]

        [Alias('UserName')]

        [string[]] $Assignee,

        [switch] $PassThru,

        [string] $AccessToken

    )

    begin

    {

        $userNames = @()

    }

    process

    {

        foreach ($name in $Assignee)

        {

            $userNames += $name

        }

    }

    end

    {

        Write-InvocationLog

        $elements = Resolve-RepositoryElements

        $OwnerName = $elements.ownerName

        $RepositoryName = $elements.repositoryName

        $telemetryProperties = @{

            'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

            'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

            'AssigneeCount' = $userNames.Count

            'Issue' =  (Get-PiiSafeString -PlainText $Issue)

        }

        $hashBody = @{

            'assignees' = $userNames

        }

        $params = @{

            'UriFragment' = "repos/$OwnerName/$RepositoryName/issues/$Issue/assignees"

            'Body' = (ConvertTo-Json -InputObject $hashBody)

            'Method' = 'Post'

            'Description' = "Add assignees to issue $Issue for $RepositoryName"

            'AccessToken' = $AccessToken

            'AcceptHeader' = $script:symmetraAcceptHeader

            'TelemetryEventName' = $MyInvocation.MyCommand.Name

            'TelemetryProperties' = $telemetryProperties

        }

        if (-not $PSCmdlet.ShouldProcess($Issue, "Add Assignee(s) $($userNames -join ',')"))

        {

            return

        }

        $result = (Invoke-GHRestMethod @params | Add-GitHubIssueAdditionalProperties)

        if (Resolve-ParameterWithDefaultConfigurationValue -Name PassThru -ConfigValueName DefaultPassThru)

        {

            return $result

        }

    }

}

function Remove-GitHubAssignee

{

<#

    .DESCRIPTION

        Removes an assignee from a GitHub issue.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER OwnerName

        Owner of the repository.

        If not supplied here, the DefaultOwnerName configuration property value will be used.

    .PARAMETER RepositoryName

        Name of the repository.

        If not supplied here, the DefaultRepositoryName configuration property value will be used.

    .PARAMETER Uri

        Uri for the repository.

        The OwnerName and RepositoryName will be extracted from here instead of needing to provide

        them individually.

    .PARAMETER Issue

        Issue number to remove the assignees from.

    .PARAMETER Assignee

        Usernames of assignees to remove from an issue.

    .PARAMETER Force

        If this switch is specified, you will not be prompted for confirmation of command execution.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .INPUTS

        GitHub.Branch

        GitHub.Content

        GitHub.Event

        GitHub.Issue

        GitHub.IssueComment

        GitHub.Label

        GitHub.Milestone

        GitHub.PullRequest

        GitHub.Project

        GitHub.ProjectCard

        GitHub.ProjectColumn

        GitHub.Reaction

        GitHub.Release

        GitHub.ReleaseAsset

        GitHub.Repository

    .OUTPUTS

        GitHub.Issue

    .EXAMPLE

        $assignees = @('octocat')

        Remove-GitHubAssignee -OwnerName microsoft -RepositoryName PowerShellForGitHub -Issue 1 -Assignee $assignee

        Removes the specified usernames from the assignee list for Issue #1

        in the microsoft\PowerShellForGitHub project.

    .EXAMPLE

        $assignees = @('octocat')

        $repo = Get-GitHubRepository -OwnerName microsoft -RepositoryName PowerShellForGitHub

        $repo | Remove-GitHubAssignee -Issue 1 -Assignee $assignee

        Removes the specified usernames from the assignee list for Issue #1

        in the microsoft\PowerShellForGitHub project.

        Will not prompt for confirmation because -Confirm:$false was specified

    .EXAMPLE

        $assignees = @('octocat')

        Get-GitHubRepository -OwnerName microsoft -RepositoryName PowerShellForGitHub |

            Get-GitHubIssue -Issue 1 |

            Remove-GitHubAssignee -Assignee $assignee

        Removes the specified usernames from the assignee list for Issue #1

        in the microsoft\PowerShellForGitHub project.

        Will not prompt for confirmation because -Force was specified

    .EXAMPLE

        $octocat = Get-GitHubUser -UserName 'octocat'

        $octocat | Remove-GitHubAssignee -OwnerName microsoft -RepositoryName PowerShellForGitHub -Issue 1

        Removes the specified usernames from the assignee list for Issue #1

        in the microsoft\PowerShellForGitHub project.

    .NOTES

        Only users with push access can remove assignees from an issue.

        Assignees are silently ignored otherwise.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParameterSetName='Elements',

        ConfirmImpact="High")]

    [OutputType({$script:GitHubIssueTypeName})]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="The Uri parameter is only referenced by Resolve-RepositoryElements which get access to it from the stack via Get-Variable -Scope 1.")]

    param(

        [Parameter(ParameterSetName='Elements')]

        [string] $OwnerName,

        [Parameter(ParameterSetName='Elements')]

        [string] $RepositoryName,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName,

            ParameterSetName='Uri')]

        [Alias('RepositoryUrl')]

        [string] $Uri,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName)]

        [Alias('IssueNumber')]

        [int64] $Issue,

        [Parameter(

            Mandatory,

            ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [Alias('UserName')]

        [string[]] $Assignee,

        [switch] $Force,

        [string] $AccessToken

    )

    begin

    {

        $userNames = @()

    }

    process

    {

        foreach ($name in $Assignee)

        {

            $userNames += $name

        }

    }

    end

    {

        Write-InvocationLog

        $elements = Resolve-RepositoryElements

        $OwnerName = $elements.ownerName

        $RepositoryName = $elements.repositoryName

        $telemetryProperties = @{

            'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

            'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

            'AssigneeCount' = $Assignee.Count

            'Issue' =  (Get-PiiSafeString -PlainText $Issue)

        }

        $hashBody = @{

            'assignees' = $userNames

        }

        if ($Force -and (-not $Confirm))

        {

            $ConfirmPreference = 'None'

        }

        if (-not $PSCmdlet.ShouldProcess($Issue, "Remove assignee(s) $($userNames -join ', ')"))

        {

            return

        }

        $params = @{

            'UriFragment' = "repos/$OwnerName/$RepositoryName/issues/$Issue/assignees"

            'Body' = (ConvertTo-Json -InputObject $hashBody)

            'Method' = 'Delete'

            'Description' = "Removing assignees from issue $Issue for $RepositoryName"

            'AccessToken' = $AccessToken

            'AcceptHeader' = $script:symmetraAcceptHeader

            'TelemetryEventName' = $MyInvocation.MyCommand.Name

            'TelemetryProperties' = $telemetryProperties

        }

        return (Invoke-GHRestMethod @params | Add-GitHubIssueAdditionalProperties)

    }

}

# SIG # Begin signature block

# MIIjkgYJKoZIhvcNAQcCoIIjgzCCI38CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBz3z2ID4pp4eIp

# YUjMie77yzpOOkFpmc61OUq71HNGz6CCDYEwggX/MIID56ADAgECAhMzAAABh3IX

# chVZQMcJAAAAAAGHMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ3WhcNMjEwMzAzMTgzOTQ3WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDOt8kLc7P3T7MKIhouYHewMFmnq8Ayu7FOhZCQabVwBp2VS4WyB2Qe4TQBT8aB

# znANDEPjHKNdPT8Xz5cNali6XHefS8i/WXtF0vSsP8NEv6mBHuA2p1fw2wB/F0dH

# sJ3GfZ5c0sPJjklsiYqPw59xJ54kM91IOgiO2OUzjNAljPibjCWfH7UzQ1TPHc4d

# weils8GEIrbBRb7IWwiObL12jWT4Yh71NQgvJ9Fn6+UhD9x2uk3dLj84vwt1NuFQ

# itKJxIV0fVsRNR3abQVOLqpDugbr0SzNL6o8xzOHL5OXiGGwg6ekiXA1/2XXY7yV

# Fc39tledDtZjSjNbex1zzwSXAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhov4ZyO96axkJdMjpzu2zVXOJcsw

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU4Mzg1MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAixmy

# S6E6vprWD9KFNIB9G5zyMuIjZAOuUJ1EK/Vlg6Fb3ZHXjjUwATKIcXbFuFC6Wr4K

# NrU4DY/sBVqmab5AC/je3bpUpjtxpEyqUqtPc30wEg/rO9vmKmqKoLPT37svc2NV

# BmGNl+85qO4fV/w7Cx7J0Bbqk19KcRNdjt6eKoTnTPHBHlVHQIHZpMxacbFOAkJr

# qAVkYZdz7ikNXTxV+GRb36tC4ByMNxE2DF7vFdvaiZP0CVZ5ByJ2gAhXMdK9+usx

# zVk913qKde1OAuWdv+rndqkAIm8fUlRnr4saSCg7cIbUwCCf116wUJ7EuJDg0vHe

# yhnCeHnBbyH3RZkHEi2ofmfgnFISJZDdMAeVZGVOh20Jp50XBzqokpPzeZ6zc1/g

# yILNyiVgE+RPkjnUQshd1f1PMgn3tns2Cz7bJiVUaqEO3n9qRFgy5JuLae6UweGf

# AeOo3dgLZxikKzYs3hDMaEtJq8IP71cX7QXe6lnMmXU/Hdfz2p897Zd+kU+vZvKI

# 3cwLfuVQgK2RZ2z+Kc3K3dRPz2rXycK5XCuRZmvGab/WbrZiC7wJQapgBodltMI5

# GMdFrBg9IeF7/rP4EqVQXeKtevTlZXjpuNhhjuR+2DMt/dWufjXpiW91bo3aH6Ea

# jOALXmoxgltCp1K7hrS6gmsvj94cLRf50QQ4U8Qwggd6MIIFYqADAgECAgphDpDS

# AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0

# ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla

# MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT

# H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG

# OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S

# 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz

# y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7

# 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u

# M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33

# X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl

# XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP

# 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB

# l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF

# RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM

# CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ

# BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud

# DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO

# 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0

# LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p

# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB

# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw

# cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA

# XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY

# 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj

# 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd

# d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ

# Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf

# wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ

# aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j

# NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B

# xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96

# eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7

# r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I

# RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVZzCCFWMCAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAYdyF3IVWUDHCQAAAAABhzAN

# BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgfQXyTOEF

# aAIl7+lEklkOgVh835Unr/7Xgjtfb4KMA/IwQgYKKwYBBAGCNwIBDDE0MDKgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN

# BgkqhkiG9w0BAQEFAASCAQBiaq09Y+XSPINpVU8s9GgePws79sJXacBb0VveddCa

# SLMgLN5+txtQlDMSV26GTlj746Wnwe0hu6qKcp4nHCOt8oU+YpD0BkRdtL4zwe3R

# 5b68hEBF6eNrRoAgvWmJtcTovZ2Fp0YVR9OLXuzGCywHKUiSZw1/4eSmaY/DlPgt

# HA2CRnx8NVkKSj7/ZY9u8OX0XxbG6hYj0fDMxZtLMtHwjYcKEB1zb4V9Xw+JWEnc

# rdNCjmsP7vRpd6tB6EcwEXG5dYffd8cjpkhfFE383V9AxJDVSS1g5EbeO0XKaptO

# OrZJhUaZm63Oc5J1xzwjTdZl0mEMcowtz51dgzlXg63voYIS8TCCEu0GCisGAQQB

# gjcDAwExghLdMIIS2QYJKoZIhvcNAQcCoIISyjCCEsYCAQMxDzANBglghkgBZQME

# AgEFADCCAVUGCyqGSIb3DQEJEAEEoIIBRASCAUAwggE8AgEBBgorBgEEAYRZCgMB

# MDEwDQYJYIZIAWUDBAIBBQAEIHInR6sISLJ+17zjQUWxTl7K3L3G4grFoKw4bTNh

# xojwAgZfO+apISoYEzIwMjAwOTA5MTU0MDMwLjI3NVowBIACAfSggdSkgdEwgc4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1p

# Y3Jvc29mdCBPcGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMg

# VFNTIEVTTjowQTU2LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt

# U3RhbXAgU2VydmljZaCCDkQwggT1MIID3aADAgECAhMzAAABJy9uo++RqBmoAAAA

# AAEnMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MB4XDTE5MTIxOTAxMTQ1OVoXDTIxMDMxNzAxMTQ1OVowgc4xCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVy

# YXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjowQTU2

# LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vydmlj

# ZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAPgB3nERnk6fS40vvWeD

# 3HCgM9Ep4xTIQiPnJXE9E+HkZVtTsPemoOyhfNAyF95E/rUvXOVTUcJFL7Xb16jT

# KPXONsCWY8DCixSDIiid6xa30TiEWVcIZRwiDlcx29D467OTav5rA1G6TwAEY5rQ

# jhUHLrOoJgfJfakZq6IHjd+slI0/qlys7QIGakFk2OB6mh/ln/nS8G4kNRK6Do4g

# xDtnBSFLNfhsSZlRSMDJwFvrZ2FCkaoexd7rKlUNOAAScY411IEqQeI1PwfRm3aW

# bS8IvAfJPC2Ah2LrtP8sKn5faaU8epexje7vZfcZif/cbxgUKStJzqbdvTBNc93n

# /Z8CAwEAAaOCARswggEXMB0GA1UdDgQWBBTl9JZVgF85MSRbYlOJXbhY022V8jAf

# BgNVHSMEGDAWgBTVYzpcijGQ80N7fEYbxTNoWoVtVTBWBgNVHR8ETzBNMEugSaBH

# hkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNU

# aW1TdGFQQ0FfMjAxMC0wNy0wMS5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUF

# BzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1RpbVN0

# YVBDQV8yMDEwLTA3LTAxLmNydDAMBgNVHRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsG

# AQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IBAQAKyo180VXHBqVnjZwQy7NlzXbo2+W5

# qfHxR7ANV5RBkRkdGamkwUcDNL+DpHObFPJHa0oTeYKE0Zbl1MvvfS8RtGGdhGYG

# CJf+BPd/gBCs4+dkZdjvOzNyuVuDPGlqQ5f7HS7iuQ/cCyGHcHYJ0nXVewF2Lk+J

# lrWykHpTlLwPXmCpNR+gieItPi/UMF2RYTGwojW+yIVwNyMYnjFGUxEX5/DtJjRZ

# mg7PBHMrENN2DgO6wBelp4ptyH2KK2EsWT+8jFCuoKv+eJby0QD55LN5f8SrUPRn

# K86fh7aVOfCglQofo5ABZIGiDIrg4JsV4k6p0oBSIFOAcqRAhiH+1spCMIIGcTCC

# BFmgAwIBAgIKYQmBKgAAAAAAAjANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJv

# b3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMTAwNzAxMjEzNjU1WhcN

# MjUwNzAxMjE0NjU1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCASIw

# DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKkdDbx3EYo6IOz8E5f1+n9plGt0

# VBDVpQoAgoX77XxoSyxfxcPlYcJ2tz5mK1vwFVMnBDEfQRsalR3OCROOfGEwWbEw

# RA/xYIiEVEMM1024OAizQt2TrNZzMFcmgqNFDdDq9UeBzb8kYDJYYEbyWEeGMoQe

# dGFnkV+BVLHPk0ySwcSmXdFhE24oxhr5hoC732H8RsEnHSRnEnIaIYqvS2SJUGKx

# Xf13Hz3wV3WsvYpCTUBR0Q+cBj5nf/VmwAOWRH7v0Ev9buWayrGo8noqCjHw2k4G

# kbaICDXoeByw6ZnNPOcvRLqn9NxkvaQBwSAJk3jN/LzAyURdXhacAQVPIk0CAwEA

# AaOCAeYwggHiMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBTVYzpcijGQ80N7

# fEYbxTNoWoVtVTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC

# AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX

# zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v

# cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI

# KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDCBoAYDVR0g

# AQH/BIGVMIGSMIGPBgkrBgEEAYI3LgMwgYEwPQYIKwYBBQUHAgEWMWh0dHA6Ly93

# d3cubWljcm9zb2Z0LmNvbS9QS0kvZG9jcy9DUFMvZGVmYXVsdC5odG0wQAYIKwYB

# BQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AUABvAGwAaQBjAHkAXwBTAHQAYQB0AGUA

# bQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAAfmiFEN4sbgmD+BcQM9naOh

# IW+z66bM9TG+zwXiqf76V20ZMLPCxWbJat/15/B4vceoniXj+bzta1RXCCtRgkQS

# +7lTjMz0YBKKdsxAQEGb3FwX/1z5Xhc1mCRWS3TvQhDIr79/xn/yN31aPxzymXlK

# kVIArzgPF/UveYFl2am1a+THzvbKegBvSzBEJCI8z+0DpZaPWSm8tv0E4XCfMkon

# /VWvL/625Y4zu2JfmttXQOnxzplmkIz/amJ/3cVKC5Em4jnsGUpxY517IW3DnKOi

# PPp/fZZqkHimbdLhnPkd/DjYlPTGpQqWhqS9nhquBEKDuLWAmyI4ILUl5WTs9/S/

# fmNZJQ96LjlXdqJxqgaKD4kWumGnEcua2A5HmoDF0M2n0O99g/DhO3EJ3110mCII

# YdqwUB5vvfHhAN/nMQekkzr3ZUd46PioSKv33nJ+YWtvd6mBy6cJrDm77MbL2IK0

# cs0d9LiFAR6A+xuJKlQ5slvayA1VmXqHczsI5pgt6o3gMy4SKfXAL1QnIffIrE7a

# KLixqduWsqdCosnPGUFN4Ib5KpqjEWYw07t0MkvfY3v1mYovG8chr1m1rtxEPJdQ

# cdeh0sVV42neV8HR3jDA/czmTfsNv11P6Z0eGTgvvM9YBS7vDaBQNdrvCScc1bN+

# NR4Iuto229Nfj950iEkSoYIC0jCCAjsCAQEwgfyhgdSkgdEwgc4xCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKTAnBgNVBAsTIE1pY3Jvc29mdCBP

# cGVyYXRpb25zIFB1ZXJ0byBSaWNvMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjow

# QTU2LUUzMjktNEQ0RDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZaIjCgEBMAcGBSsOAwIaAxUAs5W4TmyDHMRM7iz6mgGojqvXHzOggYMwgYCk

# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF

# AOMDZMwwIhgPMjAyMDA5MDkxODI3MjRaGA8yMDIwMDkxMDE4MjcyNFowdzA9Bgor

# BgEEAYRZCgQBMS8wLTAKAgUA4wNkzAIBADAKAgEAAgIZDgIB/zAHAgEAAgITHzAK

# AgUA4wS2TAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB

# AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBACb+83BNZlkYx3te

# 8ARUYItLAOOq7987U4899yewMhUqvcrIJXQpXIeGFFbkzx0vUGzYYaw7wX5W6mSh

# spOaW6EB4tCOANQknAmNLG8fmYz4f3Q8hs/fW60Ma6RlNmQ/w1APPWfHPL4dVLJb

# TmQtuVjGHEWH0yeOB/QSr9K68fd/MYIDDTCCAwkCAQEwgZMwfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTACEzMAAAEnL26j75GoGagAAAAAAScwDQYJYIZIAWUD

# BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B

# CQQxIgQgM0xHB9/1o5Hsn7xUFv8jB35jMyrJGBhmffSLNcaKeV8wgfoGCyqGSIb3

# DQEJEAIvMYHqMIHnMIHkMIG9BCAbkuhLEoYdahb/BUyVszO2VDi6kB3MSaof/+8u

# 7SM+IjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB

# Jy9uo++RqBmoAAAAAAEnMCIEIMuxEiqIA8Bu3zD50l3YJ/BG6CMHvZD4CU4glUoQ

# 9BmsMA0GCSqGSIb3DQEBCwUABIIBAG+kddN7AAt2tGNUueB2Gx0RQkeT670YeSA4

# 1RzFp7S7PS2X8wazspaZg0LXUoaRNOHwsfrdt07nopuQTkfRQWjn657ABOmKQob+

# ONmvLE56UWsFn6/otEaSB2X8/87GM8feSYetQbCs/pUcxwD+lTb41UPZEYB5fu7n

# IHM3WEloj5/Vn1yBWhPwRkOjam7vN/D0SlmY1VXTXdE04OUvFI5kuuhKT0/zjjg6

# oeFEr8KTr2hPhd84s/P4L8PTavs8fI68om8qRHJLfInL+vPDPkbazBGDjEdy8OCW

# Hl2jJ7x16lpu/RrQt43atPXeKreuW+hUUc7uF4A1vLTjgBQpSZ8=

# SIG # End signature block