Enable-DistributionGroup

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

使用 Enable-DistributionGroup 指令程式，可以為尚未啟用郵件功能的現有萬用安全性群組和萬用通訊群組啟用郵件功能。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Enable-DistributionGroup
      [-Identity] <GroupIdParameter>
      [-Alias <String>]
      [-Confirm]
      [-DisplayName <String>]
      [-DomainController <Fqdn>]
      [-PrimarySmtpAddress <SmtpAddress>]
      [-WhatIf]
      [<CommonParameters>]

Description

The Enable-DistributionGroup Cmdlet mail-enables existing universal security groups and universal distribution groups by adding the email attributes that are required by Exchange. 擁有郵件功能的安全性群組和通訊群組會對其他 *-DistributionGroup 指令程式和 *-DistributionGroupMember 指令程式顯示。

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

在Exchange Server中，CommonParameters InformationVariable 和 InformationAction 無法運作。

範例

範例 1

Enable-DistributionGroup -Identity "Distribution Group1"

此範例會為名為「通訊群組 1」的萬用通訊群組啟用郵件功能。

參數

-Alias

Alias 參數會指定 Exchange 別名 (也稱為收件者的郵件昵稱) 。 此值會將收件者識別為啟用郵件的物件，且不應與相同收件者 (也稱為 proxy 位址) 的多個電子郵件地址混淆。 收件者只能有一個別名值。 最大長度為 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 參數，則會針對 Alias 屬性值使用不同必要參數的值：

  • 具有使用者帳戶的收件者 (例如，使用者信箱和郵件使用者) ：使用 MicrosoftOnlineServicesID 或 UserPrincipalName 參數的左側。 例如， helpdesk@contoso.onmicrosoft.com 會產生 Alias 屬性值 helpdesk 。
  • 沒有使用者帳戶的收件者 (例如，會議室信箱、郵件連絡人和通訊群組) ：使用 Name 參數的值。 空格會移除，不支援的字元會轉換成問號 (？) 。

如果您修改現有收件者的 Alias 值，主要電子郵件地址只會在收件者受限於電子郵件地址原則的環境中自動更新， (收件者) 的 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

-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

-DisplayName

DisplayName 參數會指定群組的顯示名稱。 顯示名稱會顯示在 Exchange 系統管理中心和通訊清單中。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。

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

-DomainController

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

-Identity

Identity 參數會指定要啟用郵件功能的萬用安全性群組或萬用通訊群組。 您可以使用唯一識別群組的任何值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • GUID
Type:GroupIdParameter
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

-PrimarySmtpAddress

PrimarySmtpAddress 參數會指定用於收件者的主要回覆電子郵件地址。

根據預設，主要 SMTP 位址會根據預設電子郵件地址原則和 Alias 參數或 Name 屬性的值來產生。 如果您使用 PrimarySmtpAddress 參數來指定主要電子郵件地址，EmailAddressPolicyEnabled 屬性會設定為 False 值，這表示電子郵件地址原則不會自動更新群組的電子郵件地址。

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

-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

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。