Set-Group

  • 發行項

 

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

上次修改主題的時間： 2009-05-12

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

語法

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

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

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

詳細描述

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

您無法使用 Set-Group 指令程式修改動態通訊群組。若要修改動態通訊群組，請使用 Set-DynamicDistributionGroup 指令程式。

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

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

  • 適當 Active Directory 容器的帳戶操作員角色

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

參數

參數 必要 類型 描述

Identity

必要

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

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

  • 辨別名稱 (DN)

  • 標準名稱

  • GUID

  • 名稱

  • 顯示名稱

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

Confirm

選用

System.Management.Automation.SwitchParameter

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

DisplayName

選用

System.String

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

DomainController

選用

Microsoft.Exchange.Data.Fqdn

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

IgnoreDefaultScope

選用

System.Management.Automation.SwitchParameter

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

  • 您無法使用 DomainController 參數。此命令會自動使用適當的通用類別目錄伺服器。

  • 您只可以針對 Identity 參數使用 DN。不接受其他形式的識別碼 (如別名或 GUID)。

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。

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-Group 命令，將下列變更套用至名為 Legal Department 的現有全域安全性群組：

  • 將群組的範圍變更為 universal。

  • 新增 Notes 值 verified。

Set-Group -Identity "Legal Department" -Universal -Notes "verified"