Get-RoleAssignmentPolicy

模組:
Exchange PowerShell

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

使用 Get-RoleAssignmentPolicy Cmdlet 來檢視組織中現有的管理角色指派原則。

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

語法

Default (預設值) 

Get-RoleAssignmentPolicy
    [[-Identity] <MailboxPolicyIdParameter>]
    [-DomainController <Fqdn>]
    [<CommonParameters>]

Description

如需指派原則的詳細資訊，請參閱 瞭解管理角色指派原則。

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

範例

範例 1

Get-RoleAssignmentPolicy

此範例會傳回所有現有角色指派原則的清單。

範例 2

Get-RoleAssignmentPolicy "End User Policy" | Format-List

此範例會傳回指定指派原則的詳細資料。 Get-RoleAssignmentPolicy Cmdlet 的輸出會透過管道傳送至 Format-List Cmdlet。

如需管線和 Format-List Cmdlet 的詳細資訊，請參閱 關於管線 和 使用命令輸出。

範例 3

Get-RoleAssignmentPolicy | Where { $_.IsDefault -eq $True }

這個範例會傳回預設的指派原則。

Get-RoleAssignmentPolicy Cmdlet 的輸出會透過管道傳送至 Where Cmdlet。 Where Cmdlet 會篩選掉所有原則，但將 IsDefault 屬性設定為 $True 的原則除外。

如需管線和 Format-List Cmdlet 的詳細資訊，請參閱 關於管線 和 使用命令輸出。

參數

-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。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

參數屬性

類型:Fqdn
預設值: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 參數會指定要檢視的指派原則名稱。 如果名稱包含空格，請使用引號 (") 括住名稱。

警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。

參數屬性

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

參數集

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

CommonParameters

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

輸入

Input types

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

輸出

Output types

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