Set-DistributionGroup

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 Set-DistributionGroup cmdlet 修改现有通讯组或已启用邮箱的安全组的设置。 若要添加或删除组成员,请使用 Add-DistributionGroupMember、Remove-DistributionGroupMember 或 Update-DistributionGroupMember cmdlet。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Set-DistributionGroup
   [-Identity] <DistributionGroupIdParameter>
   [-AcceptMessagesOnlyFrom <MultiValuedProperty>]
   [-AcceptMessagesOnlyFromDLMembers <MultiValuedProperty>]
   [-AcceptMessagesOnlyFromSendersOrMembers <MultiValuedProperty>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-BccBlocked <Boolean>]
   [-BypassModerationFromSendersOrMembers <MultiValuedProperty>]
   [-BypassNestedModerationEnabled <Boolean>]
   [-BypassSecurityGroupManagerCheck]
   [-Confirm]
   [-CreateDTMFMap <Boolean>]
   [-CustomAttribute1 <String>]
   [-CustomAttribute10 <String>]
   [-CustomAttribute11 <String>]
   [-CustomAttribute12 <String>]
   [-CustomAttribute13 <String>]
   [-CustomAttribute14 <String>]
   [-CustomAttribute15 <String>]
   [-CustomAttribute2 <String>]
   [-CustomAttribute3 <String>]
   [-CustomAttribute4 <String>]
   [-CustomAttribute5 <String>]
   [-CustomAttribute6 <String>]
   [-CustomAttribute7 <String>]
   [-CustomAttribute8 <String>]
   [-CustomAttribute9 <String>]
   [-Description <MultiValueProperty>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-EmailAddresses <ProxyAddressCollection>]
   [-EmailAddressPolicyEnabled <Boolean>]
   [-ExpansionServer <String>]
   [-ExtensionCustomAttribute1 <MultiValuedProperty>]
   [-ExtensionCustomAttribute2 <MultiValuedProperty>]
   [-ExtensionCustomAttribute3 <MultiValuedProperty>]
   [-ExtensionCustomAttribute4 <MultiValuedProperty>]
   [-ExtensionCustomAttribute5 <MultiValuedProperty>]
   [-ForceUpgrade]
   [-GrantSendOnBehalfTo <MultiValuedProperty>]
   [-HiddenFromAddressListsEnabled <Boolean>]
   [-HiddenGroupMembershipEnabled]
   [-IgnoreDefaultScope]
   [-IgnoreNamingPolicy]
   [-MailTip <String>]
   [-MailTipTranslations <MultiValuedProperty>]
   [-ManagedBy <MultiValuedProperty>]
   [-MaxReceiveSize <Unlimited>]
   [-MaxSendSize <Unlimited>]
   [-MemberDepartRestriction <MemberUpdateType>]
   [-MemberJoinRestriction <MemberUpdateType>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-Name <String>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RejectMessagesFrom <MultiValuedProperty>]
   [-RejectMessagesFromDLMembers <MultiValuedProperty>]
   [-RejectMessagesFromSendersOrMembers <MultiValuedProperty>]
   [-ReportToManagerEnabled <Boolean>]
   [-ReportToOriginatorEnabled <Boolean>]
   [-RequireSenderAuthenticationEnabled <Boolean>]
   [-ResetMigrationToUnifiedGroup]
   [-RoomList]
   [-SamAccountName <String>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-SendOofMessageToOriginatorEnabled <Boolean>]
   [-SimpleDisplayName <String>]
   [-UMDtmfMap <MultiValuedProperty>]
   [-WhatIf]
   [-WindowsEmailAddress <SmtpAddress>]
   [<CommonParameters>]

说明

通讯组用于将多个收件人组合并为电子邮件的单个联系点。 通讯组不是安全主体,因此不能向其分配权限。 但是,您可以为已启用邮件的安全组分配权限。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"

本示例将现有通讯组的显示名称从 Accounting 更改为 Accounting Group。

示例 2

Set-DistributionGroup -Identity "Bldg34 Conf Rooms" -RoomList

此示例将“Bldg34 会议室”通讯组转换为会议室列表。

示例 3

Set-DistributionGroup -Identity Ed_DirectReports -Name Ayla_DirectReports -IgnoreNamingPolicy

本示例将现有通讯组的名称从 Ed_DirectReports 更改为 Ayla_DirectReports,并忽略组命名策略。

参数

-AcceptMessagesOnlyFrom

AcceptMessagesOnlyFrom 参数指定允许谁向此收件人发送邮件。 来自其他发件人的邮件被拒绝。

此参数的有效值是组织中的单个发件人 (邮箱、邮件用户和邮件联系人) 。 可以使用唯一标识该发件人的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

可以输入以逗号分隔的多个发件人。 若要覆盖任何现有条目,请使用以下语法: Sender1,Sender2,...SenderN。 如果值包含空格或需要引号,请使用以下语法: "Sender1","Sender2",..."SenderN"

若要在不影响其他现有条目的情况下添加或删除发件人,请使用以下语法: @{Add="Sender1","Sender2"...; Remove="Sender3","Sender4"...}

为此参数指定的发件人将自动复制到 AcceptMessagesOnlyFromSendersOrMembers 属性。 因此,不能在同一命令中使用 AcceptMessagesOnlyFrom 和 AcceptMessagesOnlyFromSendersOrMembers 参数。

默认情况下,此参数为空白 ($null) ,允许此收件人接受来自所有发件人的邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AcceptMessagesOnlyFromDLMembers

AcceptMessagesOnlyFromDLMembers 参数指定允许谁向此收件人发送邮件。 来自其他发件人的邮件被拒绝。

此参数的有效值是组织中的组 (通讯组、启用邮件的安全组和动态通讯组) 。 指定组意味着允许该组的所有成员向此收件人发送邮件。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

可以输入用逗号分隔的多个组。 若要覆盖任何现有条目,请使用以下语法: Group1,Group2,...GroupN。 如果值包含空格或需要引号,请使用以下语法: "Group1","Group2",..."GroupN"

若要在不影响其他现有条目的情况下添加或删除组,请使用以下语法: @{Add="Group1","Group2"...; Remove="Group3","Group4"...}

为此参数指定的组会自动复制到 AcceptMessagesOnlyFromSendersOrMembers 属性。 因此,不能在同一命令中使用 AcceptMessagesOnlyFromDLMembers 和 AcceptMessagesOnlyFromSendersOrMembers 参数。

默认情况下,此参数为空白 ($null) ,允许此收件人接受来自所有组的邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-AcceptMessagesOnlyFromSendersOrMembers

AcceptMessagesOnlyFromSendersOrMembers 参数指定允许谁向此收件人发送邮件。 来自其他发件人的邮件被拒绝。

此参数的有效值是组织中的单个发件人和组。 单个发件人包括邮箱、邮件用户和邮件联系人。 组是通讯组、启用邮件的安全组和动态通讯组。 指定组意味着允许该组的所有成员向此收件人发送邮件。

若要为此参数指定发送方,可以使用唯一标识发件人的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

可以输入以逗号分隔的多个发件人。 若要覆盖任何现有条目,请使用以下语法: Sender1,Sender2,...SenderN。 如果值包含空格或需要引号,请使用以下语法: "Sender1","Sender2",..."SenderN"

若要在不影响其他现有条目的情况下添加或删除单个发件人或组,请使用 AcceptMessagesOnlyFrom 和 AcceptMessagesOnlyFromDLMembers 参数。

为此参数指定的单个发件人和组将分别自动复制到 AcceptMessagesOnlyFrom 和 AcceptMessagesOnlyFromDLMembers 属性。 因此,不能在同一命令中使用 AcceptMessagesOnlyFromSendersOrMembers 参数和 AcceptMessagesOnlyFrom 或 AcceptMessagesOnlyFromDLMembers 参数。

默认情况下,此参数为空白 ($null) ,允许此收件人接受来自所有发件人的邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Alias

Alias 参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。 此值将收件人标识为已启用邮件的对象,且不得与同一个收件人的多个电子邮件地址混淆(也称为代理地址)。 收件人只能有一个 Alias 值。 最大长度为 64 个字符。

别名值可以包含字母、数字和以下字符:

  • !、#、%*、+、-、/、=、?、^、_和 ~。
  • $、 &、、、、{、} 和 | 需要转义 (例如 -Alias what`'snew) 或用单引号括起来的整个值, (例如 -Alias 'what'snew' ,) 。 & Azure AD Connect 同步的“别名”值中不支持该字符。
  • 句点 (.) 必须用其他有效字符括起来, (例如 help.desk) 。
  • Unicode 字符 U+00A1 到 U+00FF。

在不指定电子邮件地址的情况下创建收件人时,指定的别名值将用于生成主电子邮件地址 (alias@domain) 。 支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。 例如,U+00F6 (ö) 在主电子邮件地址更改为 oe

如果在创建收件人时不使用 Alias 参数,则别名属性值将使用其他必需参数的值:

  • 用户帐户 (收件人,例如,用户邮箱和邮件用户) :使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。 例如, helpdesk@contoso.onmicrosoft.com 结果为 Alias 属性值 helpdesk
  • 没有用户帐户的收件人 (例如会议室邮箱、邮件联系人和通讯组) :使用 Name 参数的值。 删除空格并将不受支持的字符转换为问号 (?) 。

如果修改现有收件人的别名值,则仅在收件人受电子邮件地址策略约束的环境中自动更新主电子邮件地址, (收件人) 的 EmailAddressPolicyEnabled 属性为 True。

Alias 参数永远不会生成或更新邮件联系人或邮件用户的主电子邮件地址。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ArbitrationMailbox

此参数只在本地 Exchange 中可用。

ArbitrationMailbox 参数指定用于管理此收件人的审阅流程的仲裁邮箱。 可以使用任何能够唯一标识仲裁邮箱的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BccBlocked

此参数仅在基于云的服务中可用。

BccBlocked 参数指定在密件抄送行中使用组的成员是否不接收消息。 有效值包含:

  • $true:如果在密件抄送行中使用了组,则组成员不会收到邮件,并且发件人会收到未送达报告 (也称为 NDR 或退回邮件) 。 不会阻止邮件的其他收件人。 如果外部发送方使用密件抄送行中的组,则不会阻止该组的成员。 对于嵌套组,仅对顶级组的成员阻止消息。
  • $false:在密件抄送邮件行中使用组没有限制。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-BypassModerationFromSendersOrMembers

BypassModerationFromSendersOrMembers 参数指定允许谁在未经审查者批准的情况下向此审查收件人发送邮件。 此参数的有效值是组织中的单个发件人和组。 指定组意味着允许组的所有成员在未经审查人批准的情况下向此收件人发送邮件。

若要为此参数指定发送方,可以使用唯一标识发件人的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

若要输入多个发送方并覆盖任何现有条目,请使用以下语法: Sender1,Sender2,...SenderN。 如果值包含空格或需要引号,请使用以下语法: "Sender1","Sender2",..."SenderN"

若要在不影响任何现有条目的情况下添加或删除一个或多个发件人,请使用以下语法: @{Add="Sender1","Sender2"...; Remove="Sender3","Sender4"...}

仅当为收件人启用了审核时,此参数才有意义。 默认情况下,此参数为空白 ($null) ,这意味着来自指定审查者以外的所有发件人的邮件都会受到审查。 当审阅人向此收件人发送邮件时,不会审查邮件。 换句话说,无需使用此参数来包括审查人。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-BypassNestedModerationEnabled

ByPassNestedModerationEnabled 参数指定当审查组包含其他审查组作为成员时如何处理消息审批。 有效值包含:

  • $true:审阅者批准发送到组的邮件后,该邮件将自动批准属于该组的所有其他审查组。
  • $false:审阅者批准发送到组的邮件后,需要对作为组成员的每个审查组单独审批。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-BypassSecurityGroupManagerCheck

BypassSecurityGroupManagerCheck 开关指定是否允许非组所有者的用户修改或删除组。 不必为此开关指定值。

如果未在组的 ManagedBy 属性中定义,则需要在修改或删除组的命令中使用此开关。 若要使用此开关,你的帐户需要基于组类型的特定权限:

  • 通讯组或启用邮件的安全组:你需要是组织管理角色组的成员,或者分配有安全组创建和成员身份角色。
  • 通讯组或启用邮件的安全组:你必须是组织管理角色组的成员,或分配有安全组创建和成员资格角色。
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CreateDTMFMap

此参数只在本地 Exchange 中可用。

CreateDTMFMap 参数指定是否为收件人创建双音多频 (DTMF) 映射。 这允许在统一消息 (UM) 环境中使用电话键盘来标识收件人。 有效值包含:

  • $true:为收件人创建 DTMF 映射。 此值为默认值。
  • $true:为收件人创建 DTMF 映射。此为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CustomAttribute1

此参数指定收件人上的 CustomAttribute1 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute10

此参数指定收件人上的 CustomAttribute10 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute11

此参数指定收件人上的 CustomAttribute11 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute12

此参数指定收件人上的 CustomAttribute12 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute13

此参数指定收件人上的 CustomAttribute13 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute14

此参数指定收件人上的 CustomAttribute14 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute15

此参数指定收件人上的 CustomAttribute15 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute2

此参数指定收件人上的 CustomAttribute2 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute3

此参数指定收件人上的 CustomAttribute3 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute4

此参数指定收件人上的 CustomAttribute4 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute5

此参数指定收件人上的 CustomAttribute5 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute6

此参数指定收件人上的 CustomAttribute6 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute7

此参数指定收件人上的 CustomAttribute7 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute8

此参数指定收件人上的 CustomAttribute8 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-CustomAttribute9

此参数指定收件人上的 CustomAttribute9 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最大长度为 1024 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Description

此参数仅在基于云的服务中可用。

Description 参数指定通讯组的可选说明。 如果值包含空格,则使用引号括住该值。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-DisplayName

DisplayName 参数指定组的显示名称。 显示名称在 Exchange 管理中心和地址列表中可见。 长度不得超过 256 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

如果在组织中强制实施组命名策略,则用户需要遵循Set-OrganizationConfig cmdlet 上的 DistributionGroupNameBlockedWordList 参数指定的命名约束。 若要绕过此要求,请使用 IgnoreNamingPolicy 开关。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-DomainController

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EmailAddresses

EmailAddresses 参数指定收件人) 的所有电子邮件地址 (代理地址,包括主 SMTP 地址。 在本地 Exchange 组织中,主 SMTP 地址和其他代理地址通常由电子邮件地址策略设置。 但是,可以使用此参数为收件人配置其他代理地址。 有关详细信息,请参阅 Exchange Server 中的Email地址策略

此参数的有效语法为 "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN"。 可选的'Type 值指定电子邮件地址的类型。 有效值的示例包括:

  • SMTP:主 SMTP 地址。 在命令中只能使用此值一次。
  • SMTP:主 SMTP 地址。此值只能在命令中使用一次。
  • X400:本地 Exchange 中的 X.400 地址。
  • X500:本地 Exchange 中的 X.500 地址。

如果未包含电子邮件地址的 Type 值,则假定值为 smtp。 请注意,Exchange 不会验证自定义地址类型的语法 (包括 X.400 地址) 。 因此,需要验证任何自定义地址的格式是否正确。

如果您没有为电子邮件地址添加 值,则系统假定为值 smtp。请注意,exExchangeNoVersion 不验证自定义地址类型(包括 X.400 地址)的语法。因此,您需要验证所有自定义地址的格式是否正确。

  • 在地址上使用“类型”值 SMTP。
  • 不使用任何 Type 值或使用多个小写 smtp Type 值时的第一个电子邮件地址。
  • 请改用 PrimarySmtpAddress 参数。 不能在同一命令中使用 EmailAddresses 参数和 PrimarySmtpAddress 参数。

PrimarySmtpAddress 参数将 主电子邮件地址 和 WindowsEmailAddress 属性更新为相同的值。

若要将所有现有代理电子邮件地址替换为指定的值,请使用以下语法: "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN"

若要在不影响其他现有值的情况下添加或删除指定代理地址,请使用以下语法: @{Add="Type:EmailAddress1","Type:EmailAddress2",...; Remove="Type:EmailAddress3","Type:EmailAddress4",...}

Type:ProxyAddressCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-EmailAddressPolicyEnabled

此参数只在本地 Exchange 中可用。

EmailAddressPolicyEnabled 参数指定是否将电子邮件地址策略应用于此收件人。 有效值包含:

  • $true:Email地址策略应用于此收件人。 此值为默认值。
  • $true:对此收件人应用电子邮件地址策略。这是默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExpansionServer

此参数只在本地 Exchange 中可用。

ExpandServer 参数指定用于扩展通讯组的 Exchange 服务器。 默认值为空白 ($null) ,这意味着扩展发生在最近的可用 Exchange 服务器上。 如果指定扩展服务器,并且该服务器不可用,则无法传递发送到通讯组的任何消息。

ExpansionServer 参数指定用于展开通讯组的 exExchangeNoVersion 服务器。默认值为空 ($null),这意味着展开发生在最近的可用 exExchange2k16 邮箱服务器上。如果您指定一个展开服务器,但该服务器不可用,则无法传递任何发送到通讯组的邮件。因此,您应该考虑为展开服务器实施高可用性解决方案。

  • Exchange 2013 或更高版本的邮箱服务器。
  • Exchange 2010 中心传输服务器。

指定扩展服务器时,请使用 ExchangeLegacyDN。 可以通过运行命令来查找此值: Get-ExchangeServer <ServerName> | Format-List ExchangeLegacyDN。 此参数的示例值为“/o=Contoso/ou=Exchange 管理组 (FYDIBOHF23SPDLT) /cn=Configuration/cn=Servers/cn=Mailbox01”。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtensionCustomAttribute1

此参数指定收件人上的 ExtensionCustomAttribute1 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最多可以指定 1300 个以逗号分隔的值。

若要输入覆盖任何现有条目的多个值,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

虽然这是多值属性,但如果属性包含指定的值,筛选器"ExtensionCustomAttribute1 -eq 'Value'"将返回匹配项。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute2

此参数指定收件人上的 ExtensionCustomAttribute2 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最多可以指定 1300 个以逗号分隔的值。

若要输入覆盖任何现有条目的多个值,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

虽然这是多值属性,但如果属性包含指定的值,筛选器"ExtensionCustomAttribute2 -eq 'Value'"将返回匹配项。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute3

此参数指定收件人上的 ExtensionCustomAttribute3 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最多可以指定 1300 个以逗号分隔的值。

若要输入覆盖任何现有条目的多个值,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

虽然这是多值属性,但如果属性包含指定的值,筛选器"ExtensionCustomAttribute3 -eq 'Value'"将返回匹配项。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute4

此参数指定收件人上的 ExtensionCustomAttribute4 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最多可以指定 1300 个以逗号分隔的值。

若要输入覆盖任何现有条目的多个值,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

虽然这是多值属性,但如果属性包含指定的值,筛选器"ExtensionCustomAttribute4 -eq 'Value'"将返回匹配项。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ExtensionCustomAttribute5

此参数指定收件人上的 ExtensionCustomAttribute5 属性的值。 可以使用此属性来存储有关收件人的自定义信息,并在筛选器中标识收件人。 最多可以指定 1300 个以逗号分隔的值。

若要输入覆盖任何现有条目的多个值,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

虽然这是多值属性,但如果属性包含指定的值,筛选器"ExtensionCustomAttribute5 -eq 'Value'"将返回匹配项。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ForceUpgrade

ForceUpgrade 开关禁止在 Exchange 的早期版本中创建对象时出现的确认消息。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-GrantSendOnBehalfTo

GrantSendOnBehalfTo 参数指定谁可以代表此组发送邮件。 尽管代表组发送的邮件在“发件人”字段中清楚地显示发件人 (<Sender> on behalf of <Group>) ,但对这些邮件的答复将传递到组,而不是发件人。

为此参数指定的发件人必须是邮箱、邮件用户或已启用邮件的安全组(已分配了权限的已启用邮件的安全主体)。 可以使用唯一标识该发件人的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

若要输入多个值并覆盖任何现有条目,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value1","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

默认情况下,此参数为空,表示其他人均无权代表此组发送邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HiddenFromAddressListsEnabled

HiddenFromAddressListsEnabled 参数指定此收件人在地址列表中是否可见。 有效值包含:

  • $true:收件人在地址列表中不可见。
  • $false:收件人在地址列表中可见。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-HiddenGroupMembershipEnabled

此参数仅在基于云的服务中可用。

保留此参数以供 Microsoft 内部使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Identity 参数指定您要修改的通讯组或已启用邮件的安全组。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID
Type:DistributionGroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreDefaultScope

此参数只在本地 Exchange 中可用。

IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置,并将整个林用作范围。 不必为此开关指定值。

此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象,但也引入了以下限制:

  • 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
  • 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IgnoreNamingPolicy

IgnoreNamingPolicy 开关指定是否防止此组受到组织的组命名策略的影响。 不必为此开关指定值。

组命名策略由 Set-OrganizationConfig cmdlet 上的 DistributionGroupNamingPolicy 和 DistributionGroupNameBlockedWordList 参数定义。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailTip

MailTip 参数指定此收件人的自定义邮件提示文本。 当发件人开始起草发送给此收件人的电子邮件时,邮件提示会显示给他们。 如果值中有空格,请使用双引号 (") 将此值括起来。

MailTip 参数指定此收件人的自定义邮件提示文本。发件人在开始草拟发送给此收件人的电子邮件时就可以看到邮件提示。如果值中有空格,请使用双引号 (") 将此值括起来。

  • HTML 标记会自动添加到文本中。 例如,如果输入文本:“此邮箱不受监视”,邮件提示将自动变为: <html><body>This mailbox is not monitored</body></html>。 不支持其他 HTML 标记,并且邮件提示的长度不能超过 175 个显示字符。
  • 文本自动添加到收件人的 MailTipTranslations 属性作为默认值: default:<MailTip text>。 如果修改 MailTip 文本,默认值将在 MailTipTranslations 属性中自动更新,反之亦然。
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MailTipTranslations

MailTipTranslations 参数为 MailTip 参数定义的自定义邮件提示文本指定其他语言。 HTML 标记会自动添加到邮件提示翻译中,不支持其他 HTML 标记,并且邮件提示翻译的长度不能超过 175 个显示字符。

MailTipTranslations 参数指定由 MailTip 参数定义的自定义邮件提示文本的其他语言。系统会自动将 HTML 标记添加到邮件提示翻译中,但不支持其他 HTML 标记。邮件提示翻译的长度不得超过 175 个显示字符。

@{Add="Culture1:Localized text 1","\Culture2:Localized text 2"...; Remove="Culture3:Localized text 3","Culture4:Localized text 4"...}.

CultureN 是与语言关联的有效 ISO 639 双字母区域性代码。

例如,假设此收件人当前具有邮件提示文本:“此邮箱不受监视。若要添加西班牙语翻译,请对此参数使用以下值: @{Add="ES:Esta caja no se supervisa."}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ManagedBy

ManagedBy 参数指定组的所有者。 组必须至少有一个所有者。 如果在创建组时不使用此参数指定所有者,则创建组的用户帐户是所有者。 组所有者能够:

  • ManagedBy 参数指定组的所有者。组至少必须有一个所有者。如果您在创建组时没有使用此参数指定所有者,则创建此组的用户帐户即为所有者。组所有者可以:
  • 修改组的属性
  • 添加或删除组成员
  • 删除组
  • 审批成员的离开或加入请求(若有)

为此参数指定的所有者必须是邮箱、邮件用户或启用邮件的安全组, (可以分配) 权限的已启用邮件的安全主体。

注意:如果所有者是已启用邮件的安全组,则 Outlook 中的组管理不起作用。 若要在 Outlook 中管理组,所有者必须是邮箱或邮件用户。 如果将启用邮件的安全组指定为组的所有者,则组在我拥有的组所有者的 通讯组中 不可见, (启用邮件的安全组的成员) 。

可以使用任何能够唯一标识此所有者的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

若要输入多个所有者并覆盖所有现有条目,请使用以下语法: Owner1,Owner2,...OwnerN。 如果值包含空格或需要引号,请使用以下语法: "Owner1","Owner2",..."OwnerN"

若要在不影响其他现有条目的情况下添加或删除所有者,请使用以下语法: @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}

使用此参数指定的所有者不会添加为组成员。 需要手动将所有者添加为成员。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MaxReceiveSize

此参数只在本地 Exchange 中可用。

MaxReceiveSize 指定可以发送到此组的电子邮件的最大大小。 超过最大大小的消息将被组拒绝。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)

TB(兆兆字节)

有效值是一个最多为 1.999999 GB(2147483647 字节)的数值或值 unlimited。 默认值为无限制,指示在其他地方施加的最大大小 (例如组织、服务器或连接器限制) 。

Base64 编码使消息的大小增加约 33%,因此请指定一个值,该值比要强制实施的实际最大消息大小大 33%。 例如,值 64 MB 会导致最大消息大小约为 48 MB。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxSendSize

此参数只在本地 Exchange 中可用。

MaxSendSize 指定此组可以发送的电子邮件的最大大小。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)

TB(兆兆字节)

有效值是一个最多为 1.999999 GB(2147483647 字节)的数值或值 unlimited。 默认值为无限制,指示在其他地方施加的最大大小 (例如组织、服务器或连接器限制) 。

Base64 编码使消息的大小增加约 33%,因此请指定一个值,该值比要强制实施的实际最大消息大小大 33%。 例如,值 64 MB 会导致最大消息大小约为 48 MB。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MemberDepartRestriction

MemberDepartRestriction 参数指定对离开组的请求施加的限制。 有效值包含:

  • 打开:成员可以在未经组所有者之一批准的情况下离开组。 这是通用通讯组的默认值。 不能在通用安全组上使用此值。
  • Open:成员可以离开组,无需得到组所有者之一的批准。 这是通用通讯组的默认值。 无法对通用安全组使用该值。
Type:MemberUpdateType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-MemberJoinRestriction

MemberJoinRestriction 参数指定对加入组的请求施加的限制。 有效值包含:

  • 打开:用户无需获得组所有者的批准即可将自己添加到组。 不能在通用安全组上使用此值。
  • 已关闭:用户无法将自己添加到组,并且自动拒绝加入组的请求。 这是通用通讯组的默认值。 这是通用安全组和通用通讯组的默认值。
  • Closed:用户无法将自己添加到组中,并自动拒绝加入组的请求。 在请求得到组所有者之一的批准后,用户将添加到组。 这是通用安全组和通用通讯组的默认值。
Type:MemberUpdateType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModeratedBy

ModeratedBy 参数指定此收件人的一个或多个审查方。 在审查方批准发送给收件人的邮件后,才能传送邮件。 审查方必须是您组织中的邮箱、邮件用户或邮件联系人。 可以使用任何能够唯一标识审查方的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

若要输入多个值并覆盖任何现有条目,请使用以下语法: Value1,Value2,...ValueN。 如果值包含空格或需要引号,请使用以下语法: "Value1","Value2",..."ValueN"

若要在不影响任何现有条目的情况下添加或删除一个或多个值,请使用以下语法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

对于已启用邮件的安全组,在将 ModerationEnabled 参数设置为值$true时,需要使用此参数指定至少一个审查器。

对于通讯组,如果将 ModerationEnabled 参数设置为值$true,但不使用此参数指定任何审查者,则 ManagedBy 参数指定的组所有者负责批准发送到组的消息。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ModerationEnabled

ModerationEnabled 参数指定是否为此收件人启用审查。 有效值包括:

  • $true:已为此收件人启用审核。 发送到此收件人的邮件必须经过审查员的批准,然后才能传递邮件。
  • $false:此收件人禁用审查。 发送给此收件人的邮件未经审阅人批准即可传递。 此值为默认值。

使用 ModeratedBy 参数指定审查器。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Name

Name 参数指定唯一的组名。 最大长度为 64 个字符。 如果值包含空格,则使用引号 (") 括住该值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PrimarySmtpAddress

PrimarySmtpAddress 参数指定对收件人使用的主要返回电子邮件地址。 不能在同一命令中使用 EmailAddresses 和 PrimarySmtpAddress 参数。

如果将 EmailAddressPolicyEnabled 参数设置为 $false,则可以使用 PrimarySmtpAddress 参数指定主地址,但电子邮件地址策略不再自动更新组的电子邮件地址。

PrimarySmtpAddress 参数将 主电子邮件地址 和 WindowsEmailAddress 属性更新为相同的值。

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RejectMessagesFrom

RejectMessagesFrom 参数指定不允许谁向此收件人发送邮件。 来自这些发件人的邮件被拒绝。

此参数的有效值是组织中的单个发件人 (邮箱、邮件用户和邮件联系人) 。 可以使用唯一标识该发件人的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

可以输入以逗号分隔的多个发件人。 若要覆盖任何现有条目,请使用以下语法: Sender1,Sender2,...SenderN。 如果值包含空格或需要引号,请使用以下语法: "Sender1","Sender2",..."SenderN"

若要在不影响其他现有条目的情况下添加或删除发件人,请使用以下语法: @{Add="Sender1","Sender2"...; Remove="Sender3","Sender4"...}

为此参数指定的发件人将自动复制到 RejectMessagesFromSendersOrMembers 属性。 因此,不能在同一命令中使用 RejectMessagesFrom 和 RejectMessagesFromSendersOrMembers 参数。

默认情况下,此参数为空白 ($null) ,允许此收件人接受来自所有发件人的邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RejectMessagesFromDLMembers

RejectMessagesFromDLMembers 参数指定不允许谁向此收件人发送邮件。 来自这些发件人的邮件被拒绝。

此参数的有效值是组织中的组 (通讯组、启用邮件的安全组和动态通讯组) 。 指定组意味着不允许该组的所有成员向此收件人发送邮件。 可以使用任何能够唯一标识该组的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

可以输入用逗号分隔的多个组。 若要覆盖任何现有条目,请使用以下语法: Group1,Group2,...GroupN。 如果值包含空格或需要引号,请使用以下语法: "Group1","Group2",..."GroupN"

若要在不影响其他现有条目的情况下添加或删除组,请使用以下语法: @{Add="Group1","Group2"...; Remove="Group3","Group4"...}

为此参数指定的组会自动复制到 RejectMessagesFromSendersOrMembers 属性。 因此,不能在同一命令中使用 RejectMessagesFromDLMembers 和 RejectMessagesFromSendersOrMembers 参数。

默认情况下,此参数为空白 ($null) ,允许此收件人接受来自所有组的邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RejectMessagesFromSendersOrMembers

RejectMessagesFromSendersOrMembers 参数指定不允许谁向此收件人发送邮件。 来自这些发件人的邮件被拒绝。

此参数的有效值是组织中的单个发件人和组。 单个发件人包括邮箱、邮件用户和邮件联系人。 组是通讯组、启用邮件的安全组和动态通讯组。 指定组意味着不允许该组的所有成员向此收件人发送邮件。

若要为此参数指定发送方,可以使用唯一标识发件人的任何值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 规范 DN
  • GUID

可以输入以逗号分隔的多个发件人。 若要覆盖任何现有条目,请使用以下语法: Sender1,Sender2,...SenderN。 如果值包含空格或需要引号,请使用以下语法: "Sender1","Sender2",..."SenderN"

若要在不影响其他现有条目的情况下添加或删除单个发件人或组,请使用 RejectMessagesFrom 和 RejectMessagesFromDLMembers 参数。

为此参数指定的单个发件人和组将分别自动复制到 RejectMessagesFrom 和 RejectMessagesFromDLMembers 属性。 因此,不能在同一命令中使用 RejectMessagesFromSendersOrMembers 参数和 RejectMessagesFrom 或 RejectMessagesFromDLMembers 参数。

默认情况下,此参数为空白 ($null) ,允许此收件人接受来自所有发件人的邮件。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ReportToManagerEnabled

ReportToManagerEnabled 参数指定是否将传递状态通知(也称为 DSN、未送达报告、NDR 或退回邮件)发送给组的所有者(由 ManagedBy 属性定义)。 有效值包含:

  • $true:将传递状态通知发送给组的所有者。
  • $false:传递状态通知不会发送给组的所有者。 此值为默认值。

ReportToManagerEnabled 和 ReportToOriginatorEnabled 参数影响发送到组的邮件的返回路径。 部分电子邮件服务器会拒绝没有返回路径的邮件。 因此,您应该将一个参数设置为 $false,一个设置为 $true,而不是同时设置为 $false 或 $true。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ReportToOriginatorEnabled

ReportToOriginatorEnabled 参数指定是否将传递状态通知(也称为 DSN、未送达报告、NDR 或退回邮件)发送给向组发送邮件的发件人。 有效值包含:

  • $true:将传递状态通知发送给邮件发件人。 此值为默认值。
  • $false:不会向邮件发件人发送传递状态通知。

ReportToManagerEnabled 和 ReportToOriginatorEnabled 参数影响发送到组的邮件的返回路径。 部分电子邮件服务器会拒绝没有返回路径的邮件。 因此,您应该将一个参数设置为 $false,一个设置为 $true,而不是同时设置为 $false 或 $true。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-RequireSenderAuthenticationEnabled

RequireSenderAuthenticationEnabled 参数指定是否仅接受来自经过身份验证 (内部) 发件人的消息。 有效值包含:

  • $true:仅接受来自经过身份验证 (内部) 发件人的邮件。 来自未经身份验证 (外部) 发件人的邮件将被拒绝。
  • $true:只接受经过身份验证的(内部)发件人的邮件。未经身份验证的(外部)发件人的邮件会遭到拒绝。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResetMigrationToUnifiedGroup

此参数仅在基于云的服务中可用。

ResetMigrationToUnifiedGroup 开关指定是否要重置指示正在将通讯组迁移到 Microsoft 365 组的标志。 不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RoomList

RoomList 开关指定通讯组的所有成员都是会议室邮箱。 不必为此开关指定值。

您可以为组织中的办公楼创建一个通讯组,然后将该办公楼中的所有会议室添加到该通讯组中。 会议室列表通讯组用于在 Outlook 2010 或更高版本中生成会议请求的生成位置列表。 会议室列表允许用户选择办公楼并获取有关该办公楼中所有会议室的可用性信息,而无需单独添加每个会议室。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SamAccountName

此参数只在本地 Exchange 中可用。

SamAccountName 参数(亦称为 Windows 2000 以前版本的用户帐户或组名称)指定与旧版 Microsoft Windows 客户端和服务器操作系统兼容的对象标识符。 该值可以包含字母、数字、空格、句点 (.) ,以及以下字符:!、#、$、%^、 &、-、_、{、}和 ~。 不得以句点字符结尾。 虽然允许使用 Unicode 字符,但重音符号可能会产生冲突(例如,o 和 ö 匹配)。 长度不得超过 20 个字符。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SendModerationNotifications

客户端通过代理从客户端访问服务连接到本地或远程邮箱服务器上的后端服务。 有效值包含:

  • 始终:在其邮件未获批准时通知所有发件人。 此值为默认值。
  • Always:当发件人的邮件未得到批准时,通知所有发件人。此为默认值。
  • Internal:当组织中发件人的邮件未得到批准时,通知这些发件人。

只有在 ModerationEnabled 参数具有值$true) 时,才启用审查, (此参数才有意义。

Type:TransportModerationNotificationFlags
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SendOofMessageToOriginatorEnabled

SendOofMessageToOriginatorEnabled 参数指定如何处理组成员的外出 (OOF) 邮件。 有效值包含:

  • $true:将邮件发送到组时,任何组成员的 OOF 消息将发送给邮件发件人。
  • $false:将邮件发送到组时,任何组成员的 OOF 消息不会发送给邮件发件人。 此值为默认值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-SimpleDisplayName

当仅允许一组有限的字符时,SimpleDisplayName 参数用于显示对象的替代说明。 有效字符为:

  • 如果只允许使用一组有限的字符,则 SimpleDisplayName 参数用于显示对象的备用说明。有效字符包括:
  • a – z
  • A - Z
  • 空格
  • " ' ( ) + , - . / : ?
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-UMDtmfMap

此参数只在本地 Exchange 中可用。

UMDtmfMap 参数指定双音多频 (DTMF) 收件人的映射值。 这允许在统一消息 (UM) 环境中使用电话键盘来标识收件人。 通常,会自动创建和更新这些 DTMF 值,但可以使用此参数手动进行更改。 此参数使用以下语法:

  • emailAddress:<integers>
  • lastNameFirstName:<integers>
  • firstNameLastName:<integers>

若要输入覆盖所有现有条目的值,请使用以下语法: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>

如果使用此语法并省略任何 DTMF 映射值,则这些值将从接收方中删除。 例如,如果仅 emailAddress:<integers>指定 ,则将删除所有现有的 lastNameFirstName 和 firstNameLastName 值。

若要在不影响其他现有条目的情况下添加或删除值,请使用以下语法: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}

如果使用此语法,则无需指定所有 DTMF 映射值,并且可以指定多个 DTMF 映射值。 例如,可以使用 @{Add="emailAddress:<integers1>","emailAddress:<integers2>} 为 emailAddress 添加两个新值,而不会影响现有的 lastNameFirstName 和 firstNameLastName 值。

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-WindowsEmailAddress

WindowsEmailAddress 参数指定此收件人的 Windows 电子邮件地址。 这是存在于所有环境(包括没有 Exchange 的环境)中的常见 Active Directory 属性。 对收件人使用 WindowsEmailAddress 参数会产生以下结果之一:

  • 在收件人受电子邮件地址策略约束 (EmailAddressPolicyEnabled 属性设置为收件人) 值 True 的环境中,WindowsEmailAddress 参数对 WindowsEmailAddress 属性或主电子邮件地址值没有影响。
  • 在收件人不受电子邮件地址策略约束的环境中, (EmailAddressPolicyEnabled 属性设置为收件人) 的值 False,WindowsEmailAddress 参数会将 WindowsEmailAddress 属性和主电子邮件地址更新为相同的值。

WindowsEmailAddress 属性对于电子邮件属性中的Active Directory 用户和计算机收件人可见。 属性公用名为“E-mail-Addresses”,Ldap-Display-Name 为“邮件”。 如果在 Active Directory 中修改此属性,则收件人主电子邮件地址不会更新为相同的值。

Type:SmtpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。