Set-RoleGroup
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 Set-RoleGroup Cmdlet 來修改誰可以在管理角色群組中新增或移除成員，或變更角色群組的名稱。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
CrossForest
Set-RoleGroup
[-Identity] <RoleGroupIdParameter>
-LinkedDomainController <String>
-LinkedForeignGroup <UniversalSecurityGroupIdParameter>
[-LinkedCredential <PSCredential>]
[-BypassSecurityGroupManagerCheck]
[-Confirm]
[-Description <String>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ManagedBy <MultiValuedProperty>]
[-Name <String>]
[-WhatIf]
[<CommonParameters>]
Default
Set-RoleGroup
[-Identity] <RoleGroupIdParameter>
[-Force]
[-BypassSecurityGroupManagerCheck]
[-Confirm]
[-Description <String>]
[-DisplayName <String>]
[-ManagedBy <MultiValuedProperty>]
[-Name <String>]
[-WellKnownObject <String>]
[-WhatIf]
[<CommonParameters>]
Description
如果您想要在現有的角色群組新增或移除成員，請使用 Add-RoleGroupMember 或 Remove-RoleGroupMember Cmdlet。 如果您想要在角色群組中新增或移除管理角色指派，請使用 New-ManagementRoleAssignment 或 Remove-ManagementRoleAssignment Cmdlet。 如果您想要在連結的角色群組新增或移除成員，您必須在外部樹系中的 USG) (外部通用安全性群組中新增或移除成員。 若要尋找外部 USG，請使用 Get-RoleGroup cmdlet。
如果 ManagedBy 屬性填入角色群組管理員，則設定角色群組的使用者必須是角色群組管理員。 或者，如果使用者是 Organization Management 角色群組的成員，或是直接或間接獲指派 Role Management 角色，則 BypassSecurityGroupManagerCheck 參數可用來覆寫安全性群組管理檢查。
如需角色群組的詳細資訊，請參閱了解管理角色群組。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-RoleGroup "London Recipient Administrators" -ManagedBy "David", "Christine"
此範例將角色群組管理員清單設定為倫敦收件者系統管理員角色群組上的 David 和 Christine。
範例 2
Set-RoleGroup "Seattle Administrators" -ManagedBy "Seattle Role Administrators" -BypassSecurityGroupManagerCheck
本範例會將角色群組管理員清單設定為西雅圖系統管理員角色群組上的西雅圖角色系統管理員 USG。 執行命令的使用者並未加入角色群組的 ManagedBy 內容，因此必須使用 BypassSecurityGroupManagerCheck 參數。 使用者獲指派 Role Management 角色，該角色可讓使用者略過安全性群組管理員檢查。
範例 3
$Credentials = Get-Credential
Set-RoleGroup "ContosoUsers: Toronto Recipient Admins" -LinkedDomainController dc02.contosousers.contoso.com -LinkedCredential $Credentials -LinkedForeignGroup "Toronto Tier 2 Administrators"
本範例修改現有連結角色群組 ContosoUsers： Toronto 收件者管理員上的連結外部 USG。 應該連結的外國 USG 是 Toronto Tier 2 Administrators。
第一個命令使用 Get-Credential Cmdlet 擷取認證，並將它們儲存在 $Credentials 變數中。 第二個命令修改 ContosoUsers： Toronto Recipient Admins 連結角色群組上的外部 USG。
參數
-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 Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件
Description 參數會指定使用 Get-RoleGroup Cmdlet 檢視角色群組時所顯示的描述。 請使用引號 (") 括住該描述。
參數屬性
| 類型: | String |
| 預設值: | 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 參數會指定角色群組的易記名稱。 如果名稱包含空格，請使用引號 (") 括住名稱。 此參數的最大長度為 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。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
CrossForest
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件
此參數只能在雲端式服務中使用。
強制開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| 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 參數會指定要修改的角色群組名稱。 如果名稱包含空格，請使用引號 (") 括住名稱。
參數屬性
| 類型: | RoleGroupIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-LinkedCredential
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
LinkedCredential 參數會指定用來存取 LinkedDomainController 參數所指定網域控制站的使用者名稱和密碼。
此參數的值需要使用 Get-Credential Cmdlet。 若要暫停此命令並收到輸入認證的提示，請使用值 (Get-Credential)。 或者，在您執行此命令之前，將認證儲存在變數中 (例如，$cred = Get-Credential)，然後將變數名稱 ($cred) 用於此參數。 如需詳細資訊，請參閱 Get-Credential。
您只能將 LinkedCredential 參數與連結的角色群組搭配使用。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
CrossForest
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LinkedDomainController
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
LinkedDomainController 參數會指定外部 USG 所在樹系中網域控制站的完整網域名稱 (FQDN) 或 IP 位址。 您指定的網域控制站可用來取得 LinkedForeignGroup 參數所指定的外部 USG 安全性資訊。
您只能將 LinkedDomainController 參數與連結的角色群組搭配使用。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
CrossForest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LinkedForeignGroup
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
LinkedForeignGroup 參數會指定您要連結此角色群組的外部 USG 名稱。 如果外部 USG 名稱包含空格，請將名稱括在引號中 (“) 。
您只能使用 LinkedForeignGroup 參數來變更連結到現有連結角色群組的外部 USG。 您無法使用 Set-RoleGroup Cmdlet 將標準角色群組變更為連結的角色群組。 您必須使用 New-RoleGroup Cmdlet 建立角色群組。
如果您使用 LinkedForeignGroup 參數，則必須在 LinkedDomainController 參數中指定網域控制站。
參數屬性
| 類型: | UniversalSecurityGroupIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
CrossForest
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ManagedBy
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
ManagedBy 參數可指定可修改角色群組設定，或在角色群組新增或移除成員的使用者或 USG。 您使用此參數指定的清單會覆寫現有的 ManagedBy 清單。 若要新增或移除個別角色群組管理員，以及如需修改多重值屬性的詳細資訊，請參閱 修改多重值屬性。
您可以使用名稱、辨別名稱 (DN) ，或您想要新增的使用者或 USG 的主要 SMTP 位址。 如果使用者或 USG 的名稱包含空格，請以引號 (“) 括住名稱。
如果您想要新增多個使用者或 USG，請使用逗號分隔。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | 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 |
-WellKnownObject
適用：Exchange Online、內部部署信箱的內建安全性附加元件
此參數只能在雲端式服務中使用。
{{ 填滿 WellKnownObject 描述 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| 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 開關無法在安全性與合規性 PowerShell 中使用。
WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。