Set-DistributionGroup (RTM)

 

適用版本: Exchange Server 2007

上次修改主題的時間: 2007-06-05

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

語法

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-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>] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <DistributionGroup>] [-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>] [-WindowsEmailAddress <SmtpAddress>]

詳細描述

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

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

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

如需管理 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 參數指定哪些信箱使用者及擁有郵件功能的連絡人可以將電子郵件傳送給此通訊群組。AcceptMessagesOnlyFrom 參數可使用下列其中一個值作為有效的寄件者:

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

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

AcceptMessagesOnlyFromDLMembers

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

Alias

選用

System.String

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

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 參數指定多個值。

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.MailboxOrMailUserIdParameter[]

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

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

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

HiddenFromAddressListsEnabled

選用

System.Boolean

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

Instance

選用

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

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

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

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

名稱

選用

System.String

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

PrimarySmtpAddress

選用

Microsoft.Exchange.Data.SmtpAddress

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

RejectMessagesFrom

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

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

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

RejectMessagesFromDLMembers

選用

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • Name
  • 顯示名稱
  • Legacy 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 參數是在只允許有限的一組字元時,用來顯示物件的替代性描述。這組有限的字元是由 ASCII 字元 26 到 126 所組成。

UMDtmfMap

選用

Microsoft.Exchange.Data.MultiValuedProperty

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

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 技術資源中心.