Set-ManagementRoleEntry

模組:: Exchange PowerShell

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

使用 Set-ManagementRoleEntry Cmdlet 變更現有管理角色項目上的可用參數。

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

語法

Default (預設值)

Set-ManagementRoleEntry
    [-Identity] <RoleEntryIdParameter>
    [-AddParameter]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Parameters <String[]>]
    [-RemoveParameter]
    [-UnScopedTopLevel]
    [-WhatIf]
    [<CommonParameters>]

Description

Set-ManagementRoleEntry Cmdlet 會變更現有角色項目上的可用參數。如果您想要將參數新增至角色項目，則參數必須存在於上層管理角色的角色項目中。如果您想要從角色項目移除參數，子角色中不能有從您要變更的角色項目繼承這些參數的角色項目。您無法變更與內建角色相關聯的角色項目。

如需管理角色項目的詳細資訊，請參閱瞭解管理角色。

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

範例

範例 1

Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters "Anr","Database" -RemoveParameter

本範例會從 [技術支援中心人員] 角色上的 [Get-Mailbox] 角色項目移除 Anr 和資料庫參數。

範例 2

Get-ManagementRoleEntry "Help Desk Personnel\*" | Set-ManagementRoleEntry -Parameters WhatIf -AddParameter

此範例擷取技術支援中心人事角色上的角色項目清單，並使用 Set-ManagementRoleEntry cmdlet 將 WhatIf 切換新增到每個角色項目。

範例 3

Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters "DisplayName","ForwardingAddress"

本範例會將 DisplayName 和 ForwardingAddress 參數新增至第 1 層技術支援中心角色上的 Set-Mailbox 角色項目，並從角色項目中移除所有其他參數。

範例 4

Set-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Location -AddParameter -UnScopedTopLevel

在內部部署 Exchange 中，此範例會將 Location 參數新增至 IT 指令碼非範圍頂層角色的 MailboxAudit 自訂指令碼。 UnScopedTopLevel 參數需要 UnScoped 角色管理角色，預設不會指派給任何角色群組。

參數

-AddParameter

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

AddParameter 參數可指定您要新增參數至指定的角色項目。您不需要使用此參數指定值。

使用 [參數] 參數指定要新增的參數。

您無法在同一個命令中同時使用 AddParameter 參數和 RemoveParameter 參數。

參數屬性

類型:	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

-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

-Identity

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

Identity 參數會指定您要修改的角色項目。此參數使用語法： <management role>\<role entry name> (例如， CustomRole\Set-Mailbox) 。

如需管理角色項目運作方式的詳細資訊，請參閱瞭解管理角色。

如果角色項目名稱包含空格，請以引號 (“) 括住。

參數屬性

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

參數集

(All)

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

-Parameters

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

Parameters 參數會指定要在角色項目中新增或移除的參數。

參數參數具有下列模式：

與 AddParameter 參數搭配使用時，您指定的參數會新增至角色項目。
與 RemoveParameter 參數搭配使用時，您指定的參數會從角色項目中移除。
當 AddParameter 或 RemoveParameter 參數都未使用時，只有您指定的參數會包含在角色項目中。如果您指定值 $Null 且既未使用 AddParameter 參數，也未使用 RemoveParameter 參數，則會移除角色項目上的所有參數。

您可以指定多個參數，並以逗號分隔。

參數屬性

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

參數集

(All)

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

-RemoveParameter

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

RemoveParameter 參數會指定您要移除指定角色項目的參數。您不需要使用此參數指定值。

使用 [參數] 參數指定要移除的參數。

您無法在同一個命令中同時使用 AddParameter 參數和 RemoveParameter 參數。

參數屬性

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

參數集

(All)

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

-UnScopedTopLevel

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

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

根據預設，此參數僅適用於 UnScoped 角色管理角色，且該角色不會指派給任何角色群組。若要使用此參數，您必須將未限定範圍的角色管理角色新增至角色群組 (例如，新增至組織管理角色群組) 。如需詳細資訊，請參閱將角色新增至角色群組。

UnScopedTopLevel 參數會指定您要修改的角色項目位於未限定範圍的頂層角色上。您不需要使用此參數指定值。

未設定範圍的頂層管理角色只能包含自訂指令碼或非 Exchange Cmdlet。如需詳細資訊，請參閱建立未限定範圍的角色。

參數屬性

類型:	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

CommonParameters

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

輸入

Input types

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

輸出

Output types

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

意見反應

此頁面對您有幫助嗎？