New-EOPDistributionGroup

此 cmdlet 仅在 Exchange Online Protection 中可用。

使用 New-EOPDistributionGroup cmdlet 在没有 Exchange Online 邮箱的独立 Exchange Online Protection (EOP) 创建通讯组或启用邮件的安全组。 此 cmdlet 在本地 Exchange 中的 Exchange Enterprise CAL with Services 许可证中包含的 EOP 中不可用;请改为New-DistributionGroup cmdlet。

通常,同样具有本地 Active Directory 的独立 EOP 组织使用目录同步在 EOP 中创建用户和组。 但是,如果您不使用目录同步,则您可以使用 cmdlet 在 EOP 中创建和管理用户和组。

此 cmdlet 使用批处理方法,在显示 cmdlet 结果之前,有几分钟的传播延迟。

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

语法

New-EOPDistributionGroup
   -Name <String>
   -ManagedBy <String[]>
   [-Alias <String>]
   [-DisplayName <String>]
   [-Members <String[]>]
   [-Notes <String>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-Type <GroupType>]
   [<CommonParameters>]

说明

可以使用 New-EOPDistributionGroup cmdlet 创建下列类型的组:

  • 已启用邮件的通用安全组 (USG)
  • 通用通讯组

通讯组用于将多个收件人组合并为电子邮件的单个联系点。安全组则用于为多个用户授予权限。

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

示例

示例 1

New-EOPDistributionGroup -Name Managers -Type Security -ManagedBy "Kitty Petersen"

本示例创建一个名为“管理器”的已启用邮件的通用安全组,由 Kitty Petersen 管理。

示例 2

New-EOPDistributionGroup -Name "Security Team" -ManagedBy "Tyson Fawcett" -Alias SecurityTeamThree -DisplayName "Security Team" -Notes "Security leads from each division" -PrimarySmtpAddress SecTeamThree@contoso.com -Type Distribution -Members @("Tyson Fawcett","Kitty Petersen")

本示例创建一个名为“安全工作组”的通讯组,并将两个用户添加到组。

参数

-Alias

Alias 参数指定通讯组的电子邮件别名。 如果不使用 PrimarySmtpAddress 参数,Alias 参数值将用于生成主 SMTP 电子邮件地址。

Alias 的值可以包含字母、数字和以下字符 * :!、#、$、%&、'、+、-、/、=、?、^、、{、}、| _ ` 和 ~。 允许 (.) 句点,但每个句点必须用其他有效字符 (例如 help.desk) 。 还允许使用从 U+00A1 到 U+00FF 的 Unicode 字符。 别名值的最大长度为 64 个字符。

如果在创建组时不使用 Alias 参数,则 Name 参数的值将用于别名。 此值还用于主 SMTP 电子邮件地址。 空格将被删除,不受支持的字符将转换为问号 (?) 。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-DisplayName

DisplayName 参数指定 Exchange 管理中心中通讯组的名称 (EAC) 。 如果未指定 DisplayName 参数,则 Name 参数的值将用于 DisplayName 参数 .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-ManagedBy

ManagedBy 参数指定拥有组的用户。 您需要使用此参数指定至少一个组所有者。 可以使用任何能够唯一标识该用户的值。 例如:

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

可以使用以下语法指定多个 @("User1","User2",..."UserN") 所有者:

不会自动将使用此参数指定的用户添加到组中。 若要将成员添加到组中,请使用 Update-EOPDistributionGroupMember cmdlet。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-Members

Members 参数指定通讯组中的收件人(已启用邮件的对象)的初始列表。 在 Exchange Online Protection 中,有效的收件人类型为:

  • 邮件用户
  • 通讯组
  • 启用邮件功能的安全组

可以使用任何能够唯一标识该收件人的值。 例如:

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

可以使用以下语法指定多个 @("Recipient1","Recipient2",..."RecipientN") 收件人:

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-Name

Name 参数指定通讯组对象的名称。 如果未指定 DisplayName 参数,则在 Name 参数中指定的值还将用于 DisplayName 参数。

Name 参数值不能超过 64 个字符。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-Notes

Notes 参数指定对象的其他信息。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-PrimarySmtpAddress

PrimarySmtpAddress 参数指定通讯组的主返回 SMTP 电子邮件地址。

Type:SmtpAddress
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection
-Type

Type 参数指定组类型。 有效值为:

  • 分布 (此值为默认值) 。
  • 安全性
Type:GroupType
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online Protection

输入

输出