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。
- 不使用任何 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 不返回任何数据。