ActionPacks/Exchange/AddressLists/Set-ExAddressListProperties.ps1 at master · TomZille/ActionPacks · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
#Requires -Version 4.0

<#
    .SYNOPSIS
        Connect to Microsoft Exchange Server and sets the address list properties

    .DESCRIPTION

    .NOTES
        This PowerShell script was developed and optimized for ScriptRunner. The use of the scripts requires ScriptRunner.
        The customer or user is authorized to copy the script from the repository and use them in ScriptRunner.
        The terms of use for ScriptRunner do not apply to this script. In particular, AppSphere AG assumes no liability for the function,
        the use and the consequences of the use of this freely available script.
        PowerShell is a product of Microsoft Corporation. ScriptRunner is a product of AppSphere AG.
        © AppSphere AG

    .COMPONENT
        ScriptRunner Version 4.x or higher

    .LINK
        https://github.com/scriptrunner/ActionPacks/tree/master/Exchange/AddressLists

    .Parameter ListName
        Specifies the unique name of the address list from which to set properties

    .Parameter NameOfList
        Specifies the unique name of the address list from which to set properties

    .Parameter DisplayName
        Specifies the display name of the address list

    .Parameter MailContacts
        Adds mail contacts to the recipients of the address list

    .Parameter MailboxUsers
        Adds mailbox users to the recipients of the address list

    .Parameter MailGroups
        Adds mail groups to the recipients of the address list

    .Parameter MailUsers
        Adds mail users to the recipients of the address list

    .Parameter Resources
        Adds resources to the recipients of the address list
#>

param(
    [Parameter(Mandatory = $true,ParameterSetName="All Recipients")]
    [string]$ListName,
    [Parameter(Mandatory = $true,ParameterSetName="Selected Recipients")]
    [string]$NameOfList,
    [Parameter(ParameterSetName="All Recipients")]
    [Parameter(ParameterSetName="Selected Recipients")]
    [string]$DisplayName,
    [Parameter(ParameterSetName="Selected Recipients")]
    [bool]$MailContacts,
    [Parameter(ParameterSetName="Selected Recipients")]
    [bool]$MailboxUsers,
    [Parameter(ParameterSetName="Selected Recipients")]
    [bool]$MailGroups,
    [Parameter(ParameterSetName="Selected Recipients")]
    [bool]$MailUsers,
    [Parameter(ParameterSetName="Selected Recipients")]
    [bool]$Resources
)

#Clear
    try{
        $Script:resi=@()
        $Script:list=$ListName
        if($PSCmdlet.ParameterSetName  -eq "Selected Recipients"){
            if($MailContacts -eq $true){
                $Script:resi+='MailContacts'
            }
            if($MailboxUsers -eq $true){
                $Script:resi+='MailboxUsers'
            }
            if($MailGroups -eq $true){
                $Script:resi+='MailGroups'
            }
            if($MailUsers -eq $true){
                $Script:resi+='MailUsers'
            }
            if($Resources -eq $true){
                $Script:resi+='Resources'
            }
            $Script:list= $NameOfList
        }
        if([System.String]::IsNullOrWhiteSpace($resi)){
            $Script:resi+='AllRecipients'
        }
        $res= Get-AddressList -Identity $Script:list | Select-Object Name,DisplayName
        if([System.String]::IsNullOrWhiteSpace($DisplayName)){
            $DisplayName=$res.DisplayName
        }
        Set-AddressList -Identity $res.Name -DisplayName $DisplayName -IncludedRecipients ($resi -join ',') -ForceUpgrade -Confirm:$false
        $res= Get-AddressList -Identity $res.Name | Select-Object *

        if($null -ne $res){
            if($SRXEnv) {
                $SRXEnv.ResultMessage = $res
            }
            else{
                Write-Output $res
            }
        }
        else{
            if($SRXEnv) {
                $SRXEnv.ResultMessage = "Address list not found"
            }
            else{
                Write-Output  "Address list not found"
            }
        }
    }
    Finally{

    }