Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2009-05-12
Use the Enable-DistributionGroup command to mail-enable an existing universal group.
Syntax
enable-DistributionGroup -Identity
<GroupIdParameter> [-Alias <String>] [-Confirm
[<SwitchParameter>]] [-DisplayName <String>]
[-DomainController <Fqdn>] [-PrimarySmtpAddress
<SmtpAddress>] [-UseRusServer <String>] [-WhatIf
[<SwitchParameter>]]
|
Parameters
Parameter | Required | Type | Description | ||
---|---|---|---|---|---|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.GroupIdParameter |
The Identity parameter specifies the identity of the distribution group in one of the following forms:
|
||
Alias |
Optional |
System.String |
The Alias parameter specifies the e-mail alias of the group. |
||
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter. |
||
DisplayName |
Optional |
System.String |
The DisplayName parameter specifies the display name of the distribution group. A display name is typically the same as the Domain\Account Name. |
||
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
To specify the fully qualified domain name (FQDN) of the domain controller that writes this configuration change to Active Directory, include the DomainController parameter in the command. |
||
PrimarySmtpAddress |
Optional |
Microsoft.Exchange.Data.SmtpAddress |
Use this parameter to specify the primary SMTP address for the
distribution group. By default, the primary SMTP address is
generated based on the default e-mail address policy. If you
specify a primary SMTP address by using this parameter, the cmdlet
will set the EmailAddressPolicyEnabled attribute of the
distribution group to |
||
UseRusServer |
Optional |
System.String |
The UseRusServer parameter instructs the command to use the specified Mailbox server on which the Address List service is running to obtain and then set mailbox and Active Directory user attributes. The Address List service is a component in the Exchange System Attendant service. The Address List service creates and maintains Exchange-specific attribute values in Active Directory. You can use the Address List service to update recipient objects in a domain by using specific information, such as address list membership and e-mail addresses. |
||
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter. |
Detailed Description
Members of a universal group can include other groups and accounts from any domain in the domain tree or forest and can be granted permissions in any domain in the domain tree or forest. To mail-enable an existing universal group in the Active Directory directory service, you can use the Enable-DistributionGroup cmdlet.
To run the Enable-DistributionGroup cmdlet, the account you use must be delegated the following:
- Exchange Recipient Administrator role
For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.
Input Types
Return Types
Errors
Error | Description |
---|---|
|
|
Exceptions
Exceptions | Description |
---|---|
|
|
Example
The following code is an example of the Enable-DistributionGroup command.
Copy Code | |
---|---|
Enable-DistributionGroup -Identity "Distribution Group1" |