Update-RoleGroupMember

Update-RoleGroupMember
    [-Identity] <RoleGroupIdParameter>
    [-BypassSecurityGroupManagerCheck]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Members <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Update-RoleGroupMember 指令程式可讓您取代某個角色群組的整份成員資格清單，或者利用程式設計方式一次新增或移除多個成員。 您在此指令程式使用 Members 參數會指定的成員資格清單會取代特定角色群組的成員資格清單。 因此，使用此指令程式時請務必小心，才不會錯誤地覆寫角色群組成員資格。

Add-RoleGroupMember 和 Remove-RoleGroupMember 指令程式可用來新增或移除角色群組成員。 您可以將這些指令程式與其他指令程式 (例如 Get-Mailbox) 結合使用，來新增或移除多個成員，而不會一次覆寫整份成員資格清單。

如果 ManagedBy 屬性被填入角色群組管理器，則更新角色群組成員資格的使用者必須是角色群組管理器。 或者，如果使用者是 Organization Management 角色群組的成員，或是直接或間接獲指派 Role Management 角色，則 BypassSecurityGroupManagerCheck 參數可用來覆寫安全性群組管理檢查。

如果角色群組是連結的角色群組，您就無法使用 Update-RoleGroupMember 指令程式來修改角色群組的成員。 您需要修改連結到連結之角色群組之外部萬用安全性群組 (USG) 的成員。 若要尋找連結至角色群組的外部 USG，請使用 Get-RoleGroup 指令程式。

如需角色群組的詳細資訊，請參閱了解管理角色群組。

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

Update-RoleGroupMember "Recipient Administrators" -Members "Mark", "Jane", "Mary", "Fred"

此範例將接收管理者的角色群組成員列表設為 Mark、Jane、Mary 和 Fred。

Update-RoleGroupMember "Recipient Administrators" -Members "Mark", "Jane", "Mary", "Fred" -BypassSecurityGroupManagerCheck

此範例將接收管理者的角色群組成員列表設為 Mark、Jane、Mary 和 Fred。 執行命令的使用者並未加入角色群組的 ManagedBy 內容，因此必須使用 BypassSecurityGroupManagerCheck 參數。 使用者獲指派 Role Management 角色，該角色可讓使用者略過安全性群組管理員檢查。

Update-RoleGroupMember "Organization Management" -Members @{Add=(Get-Mailbox David).Identity, (Get-Group "Help Desk Managers").Identity

Remove=(Get-Mailbox "Christine").Identity, (Get-Mailbox "Isabel").Identity}

此範例是在角色群組中新增多個成員，並移除多個成員，但不會替換該角色群組中所有現有成員。 此範例使用了《 修改多值屬性》中描述的多值屬性語法。 使用這種多值屬性語法時，必須手動取得你想新增或移除的信箱或啟用郵件的安全群組的身份。 使用與你想新增或移除物件類型相符的語法：

信箱：如果你想新增或移除信箱，請使用 語法 (Get-Mailbox "<Alias or Name>").Identity。

郵件啟用安全群組：如果您想新增或移除郵件啟用的安全群組，請使用語法 (Get-Group "<Name>").Identity。

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

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

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