Set-Group

模組:
Exchange PowerShell

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。

使用 Set-Group Cmdlet 修改群組物件設定。 如果群組是啟用郵件功能的安全性群組或通訊群組，您可以使用 Set-DistributionGroup Cmdlet 來修改其他無法使用 Set-Group Cmdlet 的 Microsoft Exchange 設定。

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

語法

Default (預設值) 

Set-Group
    [-Identity] <GroupIdParameter>
    [-BypassSecurityGroupManagerCheck]
    [-Confirm]
    [-Description <MultiValueProperty>]
    [-DisplayName <String>]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-IsHierarchicalGroup <Boolean>]
    [-ManagedBy <GeneralRecipientIdParameter[]>]
    [-Name <String>]
    [-Notes <String>]
    [-PhoneticDisplayName <String>]
    [-SeniorityIndex <Int32>]
    [-SimpleDisplayName <String>]
    [-Universal]
    [-WhatIf]
    [-WindowsEmailAddress <SmtpAddress>]
    [<CommonParameters>]

Description

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

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

範例

範例 1

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

此範例會將下列變更套用至現有的全域安全性群組法務部門：

將群組的範圍變更為 [通用]。

新增 Notes 參數值 verified。

範例 2

Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1

此範例指定 [人力資源] 群組為階層式群組，並因其索引號碼為 1 而顯示在其階層內的最後。

參數

-BypassSecurityGroupManagerCheck

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

BypassSecurityGroupManagerCheck 參數可指定是否允許非群組擁有者的使用者修改或刪除群組。 您不需要使用此參數指定值。

如果未在群組的 ManagedBy 屬性中定義，則必須在修改或刪除群組的命令中使用此參數。 若要使用此切換，您的帳戶會根據群組類型需要特定權限：

  • 通訊群組或啟用郵件功能的安全性群組：您必須是組織管理角色群組的成員，或已獲指派安全性群組建立和成員資格角色。
  • 通訊群組或已啟用郵件功能的安全性群組：您必須為「組織管理」角色群組的成員，或具有「安全性群組建立及成員資格」角色指派。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Confirm 參數會指定要顯示或隱藏確認提示。 此參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 針對這些 Cmdlet，指定不帶值的 Confirm 參數會造成暫停，強制您在繼續之前先確認命令。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Description

適用：Exchange Online、內部部署信箱的內建安全性附加元件

此參數只能在雲端式服務中使用。

{{ 填滿描述描述 }}

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DisplayName

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

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

只有當群組啟用郵件時，此參數才有意義。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Identity 參數會指定您要修改的群組。 您可以使用唯一識別群組的任何值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • GUID

參數屬性

類型:GroupIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-IgnoreDefaultScope

適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此參數僅適用於內部部署 Exchange。

IgnoreDefaultScope 參數會告知命令忽略 Exchange PowerShell 工作階段的預設收件者範圍設定，並使用整個樹系作為範圍。 您不需要使用此參數指定值。

此參數可讓命令存取預設範圍中目前不可用的 Active Directory 物件，但也會引進下列限制：

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-IsHierarchicalGroup

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

IsHierarchicalGroup 參數會指定群組是否為階層式通訊錄的一部分。 有效的值為 $true 或 $false。 預設值為 $false。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ManagedBy

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

ManagedBy 參數會指定群組的擁有者。 每個群組必須至少具有一個擁有者。 如果您在建立群組時未使用此參數來指定擁有者，則建立群組的使用者帳戶就是擁有者。 群組擁有者可以：

  • ManagedBy 參數能指定群組的擁有者。每個群組必須至少具有一個擁有者。如果不使用這個參數來指定擁有者，當您建立群組時，建立群組的使用者帳戶會成為擁有者。群組擁有者能夠：
  • 修改群組的屬性
  • 新增或移除群組成員
  • 刪除群組
  • 核准成員的離開或加入要求 (如果有的話)

您為此參數指定的擁有者必須是信箱、郵件使用者或啟用郵件的安全性群組， (啟用郵件的安全性主體，且可以) 指派權限。 您可以使用唯一識別擁有者的任何值。 例如：

  • 名稱
  • 別名
  • 辨別名稱 (DN)
  • 辨別名稱 (DN)
  • 網域\使用者名稱
  • 電子郵件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 使用者識別碼或使用者主要名稱 (UPN)

若要輸入多個擁有者並覆寫所有現有項目，請使用下列語法： Owner1,Owner2,...OwnerN。 如果這些值包含空格或需要引號，請使用下列語法: "Owner1","Owner2",..."OwnerN"。

若要新增或移除擁有者而不影響其他現有項目，請使用下列語法： @{Add="Owner1","Owner2",...; Remove="Owner3","Owner4"...}。

您使用此參數指定的擁有者不會新增為群組成員。 您必須手動將擁有者新增為成員。

附註：當擁有者是啟用郵件功能的安全性群組時，Outlook 中的群組管理無法運作。 若要在 Outlook 中管理群組，擁有者必須是信箱或郵件使用者。

參數屬性

類型:

GeneralRecipientIdParameter[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Name 參數會指定群組的唯一名稱。 最大長度為 64 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Notes

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

Notes 參數會指定有關物件的額外資訊。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PhoneticDisplayName

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

PhoneticDisplayName 參數指定使用者姓名的替代拼字，其用於整合通訊 (UM) 環境中的文字轉換語音。 一般而言，當使用者姓名的發音和拼字不符時，您需要使用此參數。 最大長度為 256 個字元。 如果值包含空格，請使用引號 (") 括住值。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SeniorityIndex

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

SeniorityIndex 參數會指定此群組在階層式通訊錄中的顯示順序。 值為 2 的群組在通訊錄中顯示的位置高於值為 1 的群組。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-SimpleDisplayName

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

SimpleDisplayName 參數可用來在只允許一組有限的字元時顯示物件的替代描述。 有效字元為：

  • SimpleDisplayName 參數是在只允許有限的一組字元時，用來顯示物件的替代性描述。有效的字元為：
  • a - z
  • A - Z
  • 空格
  • " ' ( ) + , - . / : ?

只有當群組啟用郵件時，此參數才有意義。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Universal

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

通用參數會將群組的範圍從 Global 或 DomainLocal 變更為 Universal。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:WI

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WindowsEmailAddress

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱

WindowsEmailAddress 參數會指定此收件者的 Windows 電子郵件地址。 這是所有環境中都存在的常見 Active Directory 屬性，包括沒有 Exchange 的環境。 對收件者使用 WindowsEmailAddress 參數會產生下列其中一個結果：

  • 在收件者受電子郵件地址原則約束的環境中， (EmailAddressPolicyEnabled 屬性設定為收件者) 的值 True，則 WindowsEmailAddress 參數對 WindowsEmailAddress 屬性或主要電子郵件地址值沒有影響。
  • 在收件者不受電子郵件地址原則約束的環境中， (EmailAddressPolicyEnabled 屬性設定為收件者) 的值 False，WindowsEmailAddress 參數會將 WindowsEmailAddress 屬性和主要電子郵件地址更新為相同的值。

WindowsEmailAddress 屬性可在 Active Directory 使用者和電腦的電子郵件屬性中對收件者可見。 屬性公用名稱是 E-mail-Addresses，而 Ldap-Display-Name 是郵件。 如果您在 Active Directory 中修改此屬性，收件者的主要電子郵件地址不會更新為相同值。

參數屬性

類型:SmtpAddress
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

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

輸出

Output types

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