Get-ManagementRoleEntry

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Get-ManagementRoleEntry 指令程式來擷取已在管理角色設定的管理角色項目。

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

Syntax

Get-ManagementRoleEntry
   [-Identity] <RoleEntryIdParameter>
   [-DomainController <Fqdn>]
   [-Parameters <String[]>]
   [-PSSnapinName <String>]
   [-Type <ManagementRoleEntryType[]>]
   [<CommonParameters>]

Description

Get-ManagementRoleEntry 指令程式會擷取已在角色設定的角色項目。 您可以擷取符合特定準則的特定角色專案，例如角色名稱、Cmdlet 名稱、參數名稱，或每個的組合，或角色專案類型或相關聯的Windows PowerShell嵌入式管理單元。

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

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

範例

範例 1

Get-ManagementRoleEntry "Transport Rules\*"

此範例會擷取 Transport Rules 管理角色所含的所有角色項目清單。

範例 2

Get-ManagementRoleEntry *\Get-Recipient

此範例會擷取包含 Get-Recipient 指令程式的所有角色項目清單。

範例 3

Get-ManagementRoleEntry "Tier 2 Help Desk\Set-Mailbox" | Format-List Name, Parameters, Role, Type

此範例會擷取 Tier 2 Help Desk\Set-Mailbox 角色項目，並且將 Get-ManagementRoleEntry 指令程式的輸出，透過管線傳送到 Format-List 指令程式。 然後，Format-List Cmdlet 只會從角色專案輸出 Name、Parameters、Role 和 Type 屬性。

參數

-DomainController

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

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定您想要檢視的角色專案。 此參數使用語法： <management role>\<role entry name> (例如， CustomRole\Set-Mailbox) 。

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

您可以使用萬用字元 (*) ，而不是角色、Cmdlet 名稱或兩者。

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

Type:RoleEntryIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Parameters

Parameters 參數只包括內含指定之參數的角色項目。 您可以指定多個參數，以逗號分隔。 您可使用萬用字元 (*) 加上部分參數名稱，以擷取符合指定之值的所有參數。

當您使用萬用字元 (*) 加上您在 Identity 參數中指定的值時，這個參數非常有用。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-PSSnapinName

PSSnapinName 參數會指定包含要傳回之角色專案的Windows PowerShell嵌入式管理單元。 使用 Get-PSSnapin Cmdlet 來擷取可用Windows PowerShell嵌入式管理單元的清單。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Type

Type 參數會指定要傳回之角色項目的類型。 Type 參數的有效值是下列參數的任何組合，並以逗號分隔：Cmdlet、腳本和 ApplicationPermission。

Type:ManagementRoleEntryType[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

輸入

Input types

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

輸出

Output types

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