Set-Group (RTM)

  • 發行項

 

適用版本： Exchange Server 2007

上次修改主題的時間： 2007-06-17

使用 Set-Group 指令程式可修改現有 Microsoft Windows 群組的設定。

語法

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-DisplayName <String>] [-DomainController <Fqdn>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-WindowsEmailAddress <SmtpAddress>]

詳細描述

您可以使用 Set-Group 指令程式，修改可在 [Active Directory 使用者和電腦] 看到的群組物件設定。如果群組是擁有郵件功能的安全性群組或通訊群組，則可以使用 Set-DistributionGroup 指令程式來修改無法使用 Set-Group 指令程式取得的其他 Microsoft Exchange Server 2007 設定。

您無法使用 Set-Group 指令程式修改動態通訊群組。若要修改動態通訊群組，請使用 Set-DynamicDistributionGroup 指令程式。如需 Set-DynamicDistributionGroup 指令程式的相關資訊，請參閱 Set-DynamicDistributionGroup (RTM)。

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

  • Exchange 收件者系統管理員角色
  • 適當 Active Directory 容器的帳戶操作員角色

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

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Identity 參數指定您要修改的物件。Identity 參數可以使用群組的下列任何一個值：

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱

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

DisplayName

選用

System.String

DisplayName 參數指定群組在 Exchange 管理主控台及 Exchange 全域通訊清單 (GAL) 中的名稱。只有在群組擁有郵件功能時，此參數才有意義。

DomainController

選用

Microsoft.Exchange.Data.Fqdn

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

Instance

選用

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

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

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

ManagedBy

選用

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

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

  • 辨別名稱 (DN)
  • 標準名稱
  • GUID
  • 名稱
  • 顯示名稱

Name

選用

System.String

Name 參數指定群組的名稱。Name 參數指定 [Active Directory 使用者和電腦] 中的群組名稱，以及 Exchange 管理主控台 [群組名稱] 欄位中的群組名稱 (如果群組擁有郵件功能的話)。

Notes

選用

System.String

Notes 參數指定描述群組目的之附註。

PhoneticDisplayName

選用

System.String

PhoneticDisplayName 參數指定 DisplayName 參數的語音讀法。

此參數值的最大長度為 255 個字元。如需 PhoneticDisplayName 參數與語音辨識的相關資訊，請參閱了解自動語音辨識目錄查閱服務。

SimpleDisplayName

選用

System.String

SimpleDisplayName 參數會在只允許有限的一組字元時，顯示替代描述。這組有限的字元是由 ASCII 字元 26 到 126 所組成。SimpleDisplayName 只對擁有郵件功能的物件有意義。

Universal

選用

System.Management.Automation.SwitchParameter

Universal 參數可將群組的範圍從 global 或 domain local 變更為 universal。

WindowsEmailAddress

選用

Microsoft.Exchange.Data.SmtpAddress

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

輸入類型

傳回類型

錯誤

錯誤 描述

 

 

例外狀況

例外狀況 描述

 

 

範例

下列程式碼範例顯示如何使用 Set-Group 命令，將下列變更套用至名為 Legal Department 的現有全域安全性群組：

  • 將群組的範圍變更為 universal。
  • 新增 Notes 值 verified。
Set-Group -Identity "Legal Department" -Universal -Notes "verified"

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