將角色項目新增至未限定範圍的頂層角色

適用於:Exchange Server 2013

如果您想要讓新的腳本或非 Exchange Cmdlet 可供現有未限定範圍的角色使用,您可以將腳本和非 Exchange Cmdlet 新增至未限定範圍的最上層管理角色。 這些腳本和非 Exchange Cmdlet 會新增為未限定範圍最上層管理角色的管理角色專案。 然後,這些未限定範圍的最上層角色專案或任何衍生自最上層角色的未限定範圍角色都可以使用這些角色。 如需未限定範圍角色專案的詳細資訊,請參閱 瞭解管理角色

注意事項

如果要變更包含 Exchange Cmdlet 之管理角色上的角色項目,請參閱變更的角色項目

要尋找與角色相關的其他管理工作嗎? 請參閱進階權限

開始之前有哪些須知?

  • 每項程序的預估完成時間:5 分鐘

  • 您必須已獲指派權限,才能執行此程序或這些程序。 若要查看您需要的權限,請參閱 角色管理權限主題中的「管理角色」項目。

  • 您必須使用命令介面來執行這些程序。

  • 根據預設,任何管理角色群組中不會包含在未限定範圍的最上層角色上新增角色專案的能力。 您必須先將未限定範圍的角色管理角色指派給使用者,或指派給 USG) 或使用者所屬角色群組 (通用安全性群組,使用者才能新增未限定範圍的最上層角色專案。 如需將角色新增至角色群組、使用者或 USG 的詳細資訊,請參閱下列主題:

  • 如需適用於此主題中程序的快速鍵相關資訊,請參閱 Exchange 系統管理中心的鍵盤快速鍵

提示

有問題嗎? 在 Exchange 論壇中尋求協助。 瀏覽 Exchange Server 的論壇。

新增指令碼角色項目到未限定範圍的頂層角色

如果您想要將腳本新增至現有的未限定範圍角色,請使用此程式。 If you want to add a non-Exchange cmdlet to an existing unscoped role, see "Add a non-Exchange cmdlet role entry to an unscoped top-level role" later in this topic.

若要將 Windows PowerShell 指令碼新增至未限定範圍的頂層角色,您必須為該角色新增管理角色項目。 角色項目包含您要提供給該角色使用之指令碼的名稱及指令碼的參數。

腳本必須位於執行 Exchange 2013 的每部伺服器上,Microsoft Exchange Server 2013 安裝路徑的 Scripts 目錄中,使用者可能會在其中連線以執行腳本。 如果使用者擁有執行指令碼的存取權,但指令碼不是位於使用者連接的 Exchange 2013 伺服器上,就會發生錯誤。 根據預設,Scripts 目錄的路徑是 C:\Program Files\Microsoft\Exchange Server\V15\Scripts。

將指令碼複製至適當的 Exchange 2013 伺服器並決定要使用的指令碼參數後,可使用下列語法建立角色項目。

Add-ManagementRoleEntry <unscoped top-level role name>\<script filename> -Parameters <parameter 1, parameter 2, parameter...> -Type Script -UnscopedTopLevel

本範例會將BulkProvisionUsers.ps1腳本新增至 具有名稱位置 參數的 IT 腳本角色。

Add-ManagementRoleEntry "IT Scripts\BulkProvisionUsers.ps1" -Parameters Name, Location -Type Script -UnscopedTopLevel

注意事項

Add-ManagementRoleEntry Cmdlet 會執行基本驗證,以確定您只新增指令碼中存在的參數。 不過,在新增角色項目後不會進行進一步的驗證。 如果稍後新增或移除參數,您必須手動更新包含指令碼的角色項目。

新增非 Exchange Cmdlet 角色項目到未限定範圍的頂層角色

如果您想要將非 Exchange Cmdlet 新增至現有的未限定範圍角色,請使用此程式。 如果您想要將腳本新增至現有的未限定範圍角色,請參閱本主題稍早的。

若要將非 Exchange Cmdlet 新增至未限定範圍的頂層角色,您必須為該角色新增管理角色項目。 角色項目包含您要提供給該角色使用的 Cmdlet 嵌入式管理單元、Cmdlet 名稱及 Cmdlet 的參數。

如果您將非 Exchange Cmdlet 新增至新角色,Cmdlet 必須安裝在每部 Exchange 2013 伺服器上,而使用者可能連線至此處以執行 Cmdlet。 若要了解如何正確安裝與註冊包含您想要使用之 Cmdlet 的 Windows PowerShell 嵌入式管理單元,請參閱產品的說明文件。

在您於適當的 Windows 伺服器上安裝包含 Cmdlet 的 Exchange 2013 PowerShell 嵌入式管理單元,並決定應使用哪些 Cmdlet 參數之後,可使用以下語法建立角色項目。

Add-ManagementRoleEntry <unscoped top-level role name>\<cmdlet name> -PSSnapinName <snap-in name> -Parameters <parameter 1, parameter 2, parameter...> -Type Cmdlet -UnscopedTopLevel

本範例會在 Contoso 中新增Set-WidgetConfiguration Cmdlet。管理員。Cmdlet 會使用資料庫大小參數,將嵌入式管理單元嵌入至 Widget Cmdlet 角色。

Add-ManagementRoleEntry "Widget Cmdlets\Set-WidgetConfiguration" -PSSnapinName Contoso.Admin.Cmdlets -Parameters Database, Size -Type Cmdlet -UnscopedTopLevel

注意事項

Add-ManagementRoleEntry Cmdlet 會執行基本驗證,以確定您只新增 Cmdlet 中存在的參數。 不過,在新增角色項目後不會進行進一步的驗證。 如果稍後變更 Cmdlet 並新增或移除參數,您必須手動更新包含 Cmdlet 的角色項目。

其他工作

在您新增角色項目或未限定範圍的頂層角色之後,您可能還想要:

將角色項目新增至角色

管理角色群組

管理角色群組成員

將角色新增至使用者或 USG

移除使用者或 USG 的角色