共用方式為

Set-DistributionGroup

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2010-10-20

使用 Set-DistributionGroup 指令程式可以修改現有通訊群組的設定。

語法

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

詳細描述

通訊群組是用來將收件者群組合併為電子郵件的單一連絡點。通訊群組無法用來指派權限給 Active Directory 目錄服務中的網路資源。您可以使用 Set-DistributionGroup 指令程式來覆寫現有的設定，或新增設定。

若要執行 Set-DistributionGroup 指令程式，必須對您使用的帳戶委派下列項目：

  • Exchange 收件者系統管理員角色

如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色以及權利的相關資訊，請參閱權限考量。

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Identity 參數指定您要修改的物件。Identity 參數可使用下列其中一個通訊群組的值：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱
  • 別名
  • Exchange DN
  • 主要簡易郵件傳送通訊協定 (SMTP) 位址

如果指定 Instance 參數，則無法使用 Identity 參數。

AcceptMessagesOnlyFrom

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom 參數指定可將電子郵件傳送至此通訊群組的信箱使用者、郵件使用者及郵件連絡人。您也可以指定 Microsoft Exchange 作為此參數的有效收件者。如果您將通訊群組設定為只接受來自 Microsoft Exchange 收件者的郵件，它將只會接收系統產生的郵件。

AcceptMessagesOnlyFrom 參數可使用下列其中一個值作為有效的寄件者：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱
  • 別名
  • Exchange DN
  • 主要 SMTP 電子郵件地址

此參數的預設值是空白。這讓通訊群組能夠接受所有寄件者的郵件。

AcceptMessagesOnlyFromDLMembers

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFromDLMembers 參數指定其成員可以傳送電子郵件到此通訊群組的通訊群組。您可以為允許的通訊群組使用下列任何值：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱
  • 傳統 Exchange DN
  • 主要 SMTP 電子郵件地址

此參數的預設值是空白。這讓通訊群組能夠接受所有寄件者的郵件。

Alias

選用

System.String

Alias 參數可以用來指定物件的別名。Alias 的值不可包含空格。

Confirm

選用

System.Management.Automation.SwitchParameter

Confirm 參數會使得命令暫停處理，並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。

CreateDTMFMap

選用

System.Boolean

此參數指定為通訊群組建立雙音多頻 (DTMF) 對應。

CustomAttribute1

選用

System.String

CustomAttribute1 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute10

選用

System.String

CustomAttribute10 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute11

選用

System.String

CustomAttribute11 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute12

選用

System.String

CustomAttribute12 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute13

選用

System.String

CustomAttribute13 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute14

選用

System.String

CustomAttribute14 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute15

選用

System.String

CustomAttribute15 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute2

選用

System.String

CustomAttribute2 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute3

選用

System.String

CustomAttribute3 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute4

選用

System.String

CustomAttribute4 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute5

選用

System.String

CustomAttribute5 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute6

選用

System.String

CustomAttribute6 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute7

選用

System.String

CustomAttribute7 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute8

選用

System.String

CustomAttribute8 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

CustomAttribute9

選用

System.String

CustomAttribute9 參數指定自訂的屬性。您可以使用這些屬性來儲存其他資訊。

DisplayName

選用

System.String

DisplayName 參數可以用來指定 Exchange 管理主控台及 Exchange 全域通訊清單 (GAL) 中之通訊群組的名稱。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

若要指定將此組態變更寫入至 Active Directory 之網域控制站的網域全名 (FQDN)，請加入 DomainController 參數。

EmailAddresses

選用

Microsoft.Exchange.Data.ProxyAddressCollection

EmailAddresses 參數可以用來指定通訊群組的電子郵件別名。可能會使用所有有效的 Microsoft Exchange Server 2007 電子郵件地址類型。您可以使用以逗點分隔的清單，為 EmailAddresses 參數指定多個值。

important重要事項：
Exchange 2007 不會驗證自訂位址的格式是否正確。您必須確定指定的自訂位址符合該位址類型的格式需求。由於 X.400 地址在 Exchange 2007 中被視為自訂位址，所以不會加以驗證。因此，當指定 X.400 地址時，必須提供正確的語法。

EmailAddressPolicyEnabled

選用

System.Boolean

EmailAddressPolicyEnabled 參數可以用來控制將電子郵件地址原則套用至此通訊群組。有效的值為 $true 或 $false。預設值為 $true。預設會將所有可套用的電子郵件地址原則套用到此通訊群組。

ExpansionServer

選用

System.String

ExpansionServer 參數指定用來展開通訊群組的 Exchange 伺服器。輸入擴充伺服器作為傳統的 Exchange DN 值。預設行為是使用已安裝 Hub Transport server role 的最接近之 Exchange Server 2003 電腦，或是最接近的 Exchange 2007 伺服器。

GrantSendOnBehalfTo

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

GrantSendOnBehalfTo 參數指定可以代表此通訊群組進行傳送的信箱使用者。GrantSendOnBehalfTo 參數可接受下列任何一個值：

  • 辨別名稱 (DN)
  • GUID
  • 名稱
  • 顯示名稱
  • 標準名稱
  • 傳統 Exchange DN
  • 別名
  • 主要 SMTP 電子郵件地址

GrantSendOnBehalfTo 的預設值是空白。這表示沒有其他信箱使用者具有代表此通訊群組傳送的權限。

HiddenFromAddressListsEnabled

選用

System.Boolean

HiddenFromAddressListsEnabled 參數可以用來隱藏任何 Exchange 通訊清單的通訊群組。有效的值為 $true 或 $false。預設值為 $false。

IgnoreDefaultScope

選用

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 參數會指示命令略過 Exchange 管理命令介面的預設收件者範圍設定，並以整個樹系作為範圍。如此可讓命令存取目前不在預設範圍內的 Active Directory 物件。使用 IgnoreDefaultScope 參數會產生下列限制：

  • 您無法使用 DomainController 參數。此命令會自動使用適當的通用類別目錄伺服器。
  • 您只可以針對 Identity 參數使用 DN。不接受其他形式的識別碼 (如別名或 GUID)。

Instance

選用

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

Instance 參數可讓您將整個物件傳遞至要處理的命令。它主要是用於必須將整個物件傳遞至該命令的指令碼。

如果指定 Identity 參數，則無法使用 Instance 參數。

ManagedBy

選用

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

ManagedBy 參數指定在 Active Directory 物件的 [管理者] 索引標籤中出現的信箱使用者、擁有郵件功能的群組或擁有郵件功能的連絡人名稱。您可以針對此參數使用下列任何一個值：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱
  • 傳統 Exchange DN
  • 主要 SMTP 電子郵件地址

MaxReceiveSize

選用

Microsoft.Exchange.Data.Unlimited

MaxReceiveSize 參數可以用來設定可以傳送至此通訊群組的電子郵件大小上限。當您輸入值時，請以下列其中一個單位來限定值：

  • B (位元組)
  • KB (千位元組)
  • MB (百萬位元組)
  • GB
  • TB

無限定的值會視為位元組。有效的值為 0 到 2147482624 個位元組。

MaxReceiveSize 參數預設會設為 unlimited。

MaxSendSize

選用

Microsoft.Exchange.Data.Unlimited

MaxSendSize 參數可以用來指定能從此通訊群組傳送的最大允許電子郵件大小。當您輸入值時，請以下列其中一個單位來限定值：

  • B (位元組)
  • KB (千位元組)
  • MB (百萬位元組)
  • GB
  • TB

無限定的值會視為位元組。有效的值為 0 到 2147482624 個位元組。

MaxSendSize 參數預設會設為 unlimited。

Name

選用

System.String

Name 參數指定通訊群組的名稱。Name 參數指定 Active Directory 使用者和電腦中的通訊群組名稱，以及 Exchange 管理主控台 [群組名稱] 欄位中的通訊群組名稱。

PrimarySmtpAddress

選用

Microsoft.Exchange.Data.SmtpAddress

PrimarySmtpAddress 參數指定通訊群組的主要回覆 SMTP 電子郵件地址。只有在通訊群組具有多個 SMTP 電子郵件地址時，此參數才有意義。

RejectMessagesFrom

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFrom 參數指定哪些信箱使用者及擁有郵件功能的連絡人不可以將電子郵件傳送給此通訊群組。您可以為禁止的寄件者使用下列任何值：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱
  • 傳統 Exchange DN
  • 主要 SMTP 電子郵件地址

此參數的預設值是空白。這讓通訊群組能夠接受所有信箱使用者及擁有郵件功能之連絡人的郵件。

RejectMessagesFromDLMembers

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFromDLMembers 參數指定不可以將電子郵件傳送至此通訊群組的通訊群組。您可以為禁止的通訊群組使用下列任何值：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱
  • 傳統 Exchange DN
  • 主要 SMTP 電子郵件地址

此參數的預設值是空白。這讓通訊群組能夠接受所有通訊群組的郵件。

ReportToManagerEnabled

選用

System.Boolean

ReportToManagerEnabled 參數允許將傳遞回報傳送給通訊群組管理員。有效的值為 $true 或 $false。預設值為 $false。

ReportToOriginatorEnabled

選用

System.Boolean

ReportToOriginatorEnabled 參數會允許將傳遞回報傳送給將電子郵件傳送至此通訊群組的寄件者。有效的值為 $true 或 $false。預設值為 $true。

RequireSenderAuthenticationEnabled

選用

System.Boolean

RequireSenderAuthenticationEnabled 參數要求由已驗證寄件者傳遞的電子郵件。如果值為 $true，則只會接受已驗證寄件者的郵件。有效的值為 $true 或 $false。預設值為 $true。

SamAccountName

選用

System.String

SamAccountName 參數會指定執行舊版作業系統之物件的用戶端名稱。SamAccountName 參數會顯示在 Active Directory 及 Exchange 管理主控台的群組名稱 (Windows 2000 前版) 欄位中。

SendOofMessageToOriginatorEnabled

選用

System.Boolean

SendOofMessageToOriginatorEnabled 參數允許將郵件答錄機的訊息傳遞給會傳送至此通訊群組之電子郵件的寄件者。有效的值為 $true 或 $false。預設值為 $false。

SimpleDisplayName

選用

System.String

SimpleDisplayName 參數是在只允許有限的一組字元時，用來顯示物件的替代性描述。這個有限的字元組是由下列字元組成：

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

選用

Microsoft.Exchange.Data.MultiValuedProperty

此參數指定是否要為已啟用 UM 的通訊群組建立使用者定義之 DTMF 對應。

UseRusServer

選用

System.String
note附註：
只有在 Exchange 2007 SP2 中才能使用此參數。

UseRusServer 參數會指示此命令，使用通訊清單服務執行所在的指定信箱伺服器來取得並設定信箱及 Active Directory 使用者屬性。

通訊清單服務是 Exchange System Attendant 服務的一個元件。通訊清單服務會在 Active Directory 中建立並維護 Exchange 的特定屬性。您可以使用特定資訊 (如通訊清單成員資格與電子郵件地址)，透過通訊清單服務來更新網域中的收件者物件。

WhatIf

選用

System.Management.Automation.SwitchParameter

WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數，則不需要套用任何變更，就能檢視變更。您不需要為 WhatIf 參數指定任何值。

WindowsEmailAddress

選用

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 參數指定 Active Directory 物件之 [電子郵件] 欄位的值。

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列程式碼範例顯示如何使用 Set-DistributionGroup 命令，對名為 "Accounting to Accounting Group" 的現有通訊群組變更顯示名稱。

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

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.