forked from scriptrunner/ActionPacks
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathSet-ExDistributionGroupProperties.ps1
More file actions
101 lines (85 loc) · 4.2 KB
/
Copy pathSet-ExDistributionGroupProperties.ps1
File metadata and controls
101 lines (85 loc) · 4.2 KB
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
#Requires -Version 4.0
<#
.SYNOPSIS
Connect to Microsoft Exchange Server and sets the Universal distribution group properties
Only parameters with value are set
.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/DistributionGroups
.Parameter GroupName
Specifies the Name, Alias, Display name, Distinguished name, Guid or Mail address of the Universal distribution group that you want to modify
.Parameter Alias
Specifies the Exchange alias (also known as the mail nickname) for the recipient
.Parameter DisplayName
Specifies the display name of the group
.Parameter ManagedBy
Specifies specifies an owner for the group. You can use the Alias, Display name, Distinguished name, Guid or Mail address that uniquely identifies the group owner
.Parameter PrimarySmtpAddress
Specifies the primary return email address that's used for the recipient
.Parameter MemberDepartRestriction
Specifies the restrictions that you put on requests to leave the group
.Parameter MemberJoinRestriction
Specifies the restrictions that you put on requests to join the group
#>
param(
[Parameter(Mandatory = $true)]
[string]$GroupName,
[string]$Alias,
[string]$DisplayName,
[string]$ManagedBy,
[string]$PrimarySmtpAddress ,
[string]$MemberDepartRestriction='Open',
[ValidateSet('ApprovalRequired','Open','Closed')]
[string]$MemberJoinRestriction='Closed'
)
#Clear
try{
$Script:grp = Get-DistributionGroup -Identity $GroupName
if($null -ne $Script:grp){
if($PSBoundParameters.ContainsKey('Alias') -eq $true ){
Set-DistributionGroup -Identity $Script:grp.Name -Alias $Alias -ForceUpgrade -Confirm:$false
}
if($PSBoundParameters.ContainsKey('DisplayName') -eq $true ){
Set-DistributionGroup -Identity $Script:grp.Name -DisplayName $DisplayName -ForceUpgrade -Confirm:$false
}
if($PSBoundParameters.ContainsKey('ManagedBy') -eq $true ){
Set-DistributionGroup -Identity $Script:grp.Name -ManagedBy $ManagedBy -ForceUpgrade -Confirm:$false
}
if($PSBoundParameters.ContainsKey('PrimarySmtpAddress') -eq $true ){
Set-DistributionGroup -Identity $Script:grp.Name -PrimarySmtpAddress $PrimarySmtpAddress -ForceUpgrade -Confirm:$false
}
if($PSBoundParameters.ContainsKey('MemberDepartRestriction') -eq $true ){
Set-DistributionGroup -Identity $Script:grp.Name -MemberDepartRestriction $MemberDepartRestriction -ForceUpgrade -Confirm:$false
}
if($PSBoundParameters.ContainsKey('MemberJoinRestriction') -eq $true ){
Set-DistributionGroup -Identity $Script:grp.Name -MemberJoinRestriction $MemberJoinRestriction -ForceUpgrade -Confirm:$false
}
$res=@("Universal distribution group $($GroupName) modified")
$res += Get-DistributionGroup -Identity $Script:grp.Name | Select-Object *
if($SRXEnv) {
$SRXEnv.ResultMessage = $res
}
else{
Write-Output $res
}
}
else{
if($SRXEnv) {
$SRXEnv.ResultMessage = "Universal distribution group $($GroupName) not found"
}
else{
Write-Output "Universal distribution group $($GroupName) not found"
}
}
}
Finally{
}