New-RoleGroup
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。
使用 New-RoleGroup Cmdlet 建立管理角色群組。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
CrossForest
New-RoleGroup
[-Name] <String>
-LinkedDomainController <String>
-LinkedForeignGroup <UniversalSecurityGroupIdParameter>
[-LinkedCredential <PSCredential>]
[-Confirm]
[-CustomConfigWriteScope <ManagementScopeIdParameter>]
[-CustomRecipientWriteScope <ManagementScopeIdParameter>]
[-Description <String>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Force]
[-ManagedBy <MultiValuedProperty>]
[-Members <MultiValuedProperty>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
[-Roles <RoleIdParameter[]>]
[-SamAccountName <String>]
[-WellKnownObject <String>]
[-WhatIf]
[<CommonParameters>]
Default
New-RoleGroup
[-Name] <String>
[-Confirm]
[-CustomConfigWriteScope <ManagementScopeIdParameter>]
[-CustomRecipientWriteScope <ManagementScopeIdParameter>]
[-Description <String>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Force]
[-Id <Guid>]
[-ManagedBy <MultiValuedProperty>]
[-Members <MultiValuedProperty>]
[-RecipientOrganizationalUnitScope <OrganizationalUnitIdParameter>]
[-Roles <RoleIdParameter[]>]
[-SamAccountName <String>]
[-WhatIf]
[<CommonParameters>]
Description
建立角色群組時，不需要新增成員或指派管理角色。 不過，在您新增成員或將角色指派給角色群組之前，角色群組不會將任何權限授與使用者。 您也可以在建立角色群組時指定自訂設定或收件者範圍。 這些範圍會套用至角色群組建立時所建立的管理角色指派。
建立角色群組時，您可以建立群組並直接新增成員，或建立連結的角色群組。 連結的角色群組會將角色群組連結至另一個樹系中 USG) (通用安全性群組。 如果執行 Exchange 的伺服器位於資源樹系中，而您的使用者和系統管理員位於個別的使用者樹系中，建立連結的角色群組便非常有用。 如果您建立連結的角色群組，就無法直接將成員新增至其中。 您必須將成員新增至外部樹系中的 USG。
如需角色群組的詳細資訊，請參閱了解管理角色群組。
您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
New-RoleGroup -Name "Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members Kim, Martin
此範例會建立角色群組。 [郵件收件者] 和 [啟用郵件的公用資料夾] 角色會指派給角色群組，而使用者 Kim 和 Martin 會新增為成員。 由於沒有提供範圍，Kim 和 Martin 可以管理組織中任何使用者的任何收件者並重設密碼。
範例 2
New-RoleGroup -Name "Seattle Limited Recipient Management" -Roles "Mail Recipients", "Mail Enabled Public Folders" -Members John, Carol -CustomRecipientWriteScope "Seattle Recipients"
此範例會建立具有自訂收件者範圍的角色群組。 自訂收件者範圍 [西雅圖收件者] 會將指派給角色群組的角色範圍限制為將其 [城市] 屬性設為 [西雅圖] 的收件者。 [郵件收件者] 和 [啟用郵件的公用資料夾] 角色會指派給角色群組，而使用者 John 和 Carol 會新增為成員。
範例 3
New-RoleGroup -Name "Transport Rules Management" -Roles "Transport Rules" -Members "Compliance Group" -ManagedBy Isabel
此範例會建立角色群組，並讓 Isabel 透過將她新增至 ManagedBy 屬性，在角色群組中新增成員或從角色群組中移除成員。 傳輸規則角色會指派給角色群組，而合規性群組 USG 會新增為成員。
範例 4
$Credentials = Get-Credential
New-RoleGroup -Name "ContosoUsers: Toronto Recipient Admins" -LinkedDomainController dc02.contosousers.contoso.com -LinkedCredential $Credentials -LinkedForeignGroup "Toronto Administrators" -CustomRecipientWriteScope "Toronto Recipients" -Roles "Mail Recipients"
本範例會建立連結的角色群組，讓 Contoso 使用者樹系中的多倫多系統管理員 USG 成員管理位於多倫多辦公室的收件者。 自訂收件者範圍 [多倫多收件者] 會將指派給角色群組的角色範圍限制為城市屬性設定為多倫多的收件者。 郵件收件者角色已指派給角色群組。
第一個命令使用 Get-Credential Cmdlet 擷取認證，並將它們儲存在 $Credentials 變數中。 然後，使用第二個命令建立連結的角色群組。
範例 5
$RoleGroup = Get-RoleGroup "Recipient Management"
New-RoleGroup "Limited Recipient Management" -Roles $RoleGroup.Roles
此範例採用現有的角色群組，並將該角色群組的角色複製到新的自訂角色群組。 如果您想要建立類似於現有角色群組的角色群組，但不想手動建立所有的角色指派，這項功能會很有用。 例如，您可能想要建立一個角色群組，其中大部分（但不是全部）管理角色都指派給收件者管理角色群組。
第一個命令會將現有的角色群組儲存在變數中，第二個命令會建立自訂角色群組。
此範例使用變數來儲存資訊。 如需變數的詳細資訊，請參閱 關於變數。
範例 6
Remove-ManagementRoleAssignment "Distribution Groups-Limited Recipient Management"
本範例會移除您在前一個範例中建立的 [通訊群組] 管理角色與 [受限收件者管理] 角色群組之間的角色指派。
參數
-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 |
-CustomConfigWriteScope
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
CustomConfigWriteScope 參數會指定現有的設定型管理範圍，以與使用此角色群組建立的管理角色指派建立關聯。 如果管理範圍名稱包含空格，請將名稱括在引號中 (“) 。 使用 Get-ManagementScope Cmdlet 擷取現有管理範圍的清單。
參數屬性
| 類型: | ManagementScopeIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CustomRecipientWriteScope
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、內部部署的內建安全性附加元件信箱
CustomRecipientWriteScope 參數會指定現有的收件者型管理範圍，以與使用此角色群組建立的管理角色指派建立關聯。 如果管理範圍名稱包含空格，請將名稱括在引號中 (“) 。
使用 Get-ManagementScope Cmdlet 擷取現有管理範圍的清單。
如果您使用 CustomRecipientWriteScope 參數，則無法使用 RecipientOrganizationalUnitScope 參數。
參數屬性
| 類型: | ManagementScopeIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(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 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用項目：Exchange Online、安全性 & 合規性、內部部署信箱的內建安全性附加元件
此參數只能在雲端式服務中使用。
強制開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Id
適用對象：安全性 & 合規性
此參數僅適用於安全性 & 合規性 PowerShell。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | 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。
參數屬性
| 類型: | 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 參數，則必須使用 LinkedForeignGroup 參數指定外部 USG，而且不能使用 Members 參數。
參數屬性
| 類型: | 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 參數，則必須在 LinkedDomainController 參數中指定網域控制站，而且不能使用 Members 參數。
參數屬性
| 類型: | 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。
您可以使用您要新增的使用者或 USG 的名稱、辨別名稱 (DN) 或主要 SMTP 位址。 如果使用者或 USG 的名稱包含空格，請以引號 (“) 括住名稱。
如果您想要新增多個使用者或 USG，請使用逗號分隔。
參數屬性
| 類型: | MultiValuedProperty |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Members
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件
Members 參數會指定要新增為角色群組成員的信箱或啟用郵件功能的 USG。 您可以透過名稱、DN 或主要 SMTP 位址值來識別使用者或群組。 您可以指定多個成員，並以逗號分隔 (Value1,Value2,...ValueN) 。 如果值包含空格，請 ("Value 1","Value 2",..."Value N") 用引號括住該值。
如果您使用 Members 參數，則無法使用 LinkedForeignGroup、LinkedDomainController 或 LinkedCredential 參數。
參數屬性
| 類型: | 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: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientOrganizationalUnitScope
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
RecipientOrganizationalUnitScope 參數會指定組織單位 (OU) 範圍新增至角色群組建立時所建立的角色指派。 如果您使用 RecipientOrganizationalUnitScope 參數，則無法使用 CustomRecipientWriteScope 參數。 若要指定 OU，請使用下列語法：domain/ou。 如果 OU 名稱包含空格，請使用引號 (") 括住網域和 OU。
參數屬性
| 類型: | OrganizationalUnitIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Roles
適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、安全性和合規性 & 內建安全性內部部署信箱的附加元件
Roles 參數會指定建立角色群組時要指派給角色群組的管理角色。 如果角色名稱包含空格，請使用引號 (") 括住名稱。 如果想指派多個角色，請以逗號隔開角色名稱。
如需您可以指派給角色群組的內建管理角色清單，請參閱 內建管理角色。
參數屬性
| 類型: | RoleIdParameter[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SamAccountName
適用項目：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
SamAccountName 參數 (也就是 Windows 2000 之前的使用者帳戶或群組名稱) 會指定與舊版 Microsoft Windows 用戶端和伺服器作業系統相容的物件識別碼。 該值可以包含字母、數字、空格、句點 (.) ，以及下列字元：！、#、$、%、^、&、-、_、{、} 和 ~。 最後一個字元不能是句點。 允許使用 Unicode 字元，但重音字元可能會產生衝突 (，例如，o 和 ö 符合) 。 最大長度為 20 個字元。
參數屬性
| 類型: | 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
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。